home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d1 / dbskat22.arc / DBSKAT.EXE / pak / KATBOOK < prev    next >
Text File  |  1990-05-06  |  216KB  |  4,220 lines
  1.                  DBS-KAT(r) 2.25 ONLINE MANUAL "TABLE OF CONTENTS"
  2.  
  3.      The below are the find phrases (prefix them with a "=" sign) for rapid
  4.      location via Gil Yoder's Mouse Lister (ML) program (press "Home" first if
  5.      doing a find inside text).  See next screen page for more information.
  6.  
  7.      TYPE  TO-READ----------  TYPE TO-READ----------  TYPE TO-READ-----------
  8.       QK   Quick Getup/Run     NC  Novice: Cover       SD  About AFI's new
  9.       CS   Crib Sheet Page     NI  " Installation          ShareWare product:
  10.       MC   Manual: Cover           (for novices)           ShareDebate Inter-
  11.       MO   " Overview          M6  After you finish        national diskette
  12.       MR   " H/W Required          a novice install        magazine
  13.       MI   " Installation      DO  DBS-KAT Overview    M3  Why DOS 3+?
  14.       MH   " Hercules Card     TC  Techref: Cover      DS  DB-SHAREWARE Info
  15.       MF   " Floppy Boot       TS  " Search Strategy   KS  KATSCAN Instr.
  16.       MS   " Setup Program     TR  " Recovery Info.    DI  Database Integrity
  17.       MD   " Catalog Disks     TU  " Upgrading from    DU  DB Utility Progs.
  18.       ML   " Catalog Lookup        PC-KAT or pre-2.0   MK  KPRINT Instr.
  19.       MP   " Avoid Problems    UP  Upgrade from 2.0+   MQ  KATASK Instr.
  20.       ME   " Error Messages    TH  Version History     PF  Problem Form
  21.       MA   " Online Assists    OR  Order Form          MN  DBS-KAT FileNames
  22.  
  23.      Thank you for trying &/or using DBS-KAT, an internationally liked dis-
  24.      kette cataloger for power users since 1986.  DBS-KAT is one of the "Best-
  25.      Rated ShareWare Programs, Honorably Mentioned Within the Computing Com-
  26.      munity Media" by Don's Directory (January 1990 edition -- Write Don's
  27.      Directory, Box 30166, Philadelphia PA 19103).  DBS-KAT is carried by many
  28.      of the major ShareWare diskette & CD-ROM distributors.
  29.  
  30.      With DBS-KAT(R), Version 2.25, online manual reading is supported through
  31.      use of Gil Yoder's Mouse Lister (ML) program, which is made available on
  32.      shareware terms to DBS-KAT users (it comes on the ShareWare diskette) via
  33.      permission of Gil.  For full use of ML as a stand alone program, refer to
  34.      the help file by pressing F1 after invoking ML (or by printing out the
  35.      HELP.ML file by typing: COPY HELP.ML PRN).  If you like using ML, you
  36.      should financially show your support to Gil as his terms suggest.  You do
  37.      not need a mouse to use Mouse Lister (I don't have a mouse myself).
  38.  
  39.      If you are reading this page now with ML, you can press the letter "F" &
  40.      be prompted to "find".  Type any of the prior screen page "find" phrases
  41.      but prefix them with the "=" sign to immediately go to the listed docu-
  42.      mentation areas.  The "find" works downward by default, so if you're
  43.      already "down" in the manual, press "Home" first before "finding".
  44.  
  45.                                         =CS
  46.                 SINGLE SCREEN PAGE CRIB SHEET FOR DBS-KAT FUNCTIONS
  47.  
  48.      How to start the DBS-KAT programs.  Type:
  49.  
  50.      TYPE  A:READ.ME & press ENTER to learn how to print the documentation &
  51.                      install the software.
  52.      ML  KATBOOK     & press ENTER to read DBS-KAT documentation online.
  53.      KATLOOK -M      & press ENTER to initially create a system control record
  54.                      (only required once after installation).
  55.      KAT             & press ENTER to process diskettes.
  56.      KAT -UN         & press ENTER to process diskettes (take system defaults
  57.                      for diskette volume info -- the data-entry-less way!)
  58.      KATLOOK         & press ENTER to inquire against cataloged diskettes.
  59.      KPRINT          & press ENTER to run the print file utility program.
  60.      KATSCAN         & press ENTER to run the hard disk file librarian
  61.                      program.
  62.      KATSCAN [DIR command parameters]  & press ENTER to search for files
  63.                      located anywhere on the current drive.
  64.                                         =MC
  65.  
  66.  
  67.                                     DBS-KAT (R)
  68.  
  69.                             The Easy, Practical, Super
  70.                             Capacity Diskette Cataloger
  71.                            And Hard Disk Archive Utility
  72.  
  73.  
  74.                                     USER MANUAL
  75.  
  76.  
  77.                                         by
  78.                                     R.H. Martin
  79.  
  80.  
  81.  
  82.                               Applied Foresight Inc.
  83.                                   P.O. Box 20607
  84.                              Bloomington, Minn. 55420
  85.  
  86.  
  87.                                   April 28, 1990
  88.  
  89.  
  90.  
  91.                         Copyright 1986-1990 by R.H. Martin
  92.                                 All Rights Reserved
  93.  
  94.  
  95.  
  96.                           A DB-ShareWare Software Product
  97.  
  98.  
  99.  
  100.  
  101.                     A limited license is hereby granted to copy
  102.                    & distribute wholly unmodified copies of the
  103.                DBS-KAT Software Diskette which contains this manual
  104.  
  105.                    (Read the manual, "THE DB-SHAREWARE PROGRAM"
  106.                    for full details about this limited license)
  107.  
  108.  
  109.  
  110.              (DBS-KAT was originally released under the name, PC-KAT)
  111.  
  112.  
  113.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 4
  114.  
  115.  
  116.  
  117.  
  118.                                  TABLE OF CONTENTS
  119.                                  -----------------
  120.  
  121.      Table of Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
  122.      About This Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
  123.       General
  124.         Trademarks
  125.      Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
  126.       Overview
  127.       Philsophy Of DBS-KAT
  128.       Using DBS-KAT With The IBM AT
  129.         DBS-KAT Base System Features
  130.      Hardware Requirements . . . . . . . . . . . . . . . . . . . . . . . . . 8
  131.         Minimum Requirements
  132.         Recommended Options
  133.         Commentary
  134.      Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10
  135.         Overview
  136.         Installation Instructions
  137.         Installation For Non-IBM Compatible MS-DOS PC
  138.         Additional Install Information For Hard Disk Users
  139.            Who Power On Their Computer With A Startup Diskette
  140.      Updating The DBS-KAT System Control Record. . . . . . . . . . . . . . .14
  141.      Cataloging Diskettes. . . . . . . . . . . . . . . . . . . . . . . . . .22
  142.      Inquiring Against The DBS-KAT Catalog . . . . . . . . . . . . . . . . .27
  143.      Taking Care of Your Database. . . . . . . . . . . . . . . . . . . . . .31
  144.       Overview
  145.       Conservative Updating
  146.       Backup
  147.         The Log File
  148.       Integrity Analysis
  149.      Trouble Shooting Tips . . . . . . . . . . . . . . . . . . . . . . . . .35
  150.      Runtime Errors in Past DBS-KAT Versions . . . . . . . . . . . . . . . .36
  151.      Online Assistance . . . . . . . . . . . . . . . . . . . . . . . . . . .37
  152.      Appendix A: The KPRINT Print Program. . . . . . . . . . . . . . . . . .38
  153.      Appendix B: KATSCAN Hard Disk Archive Utility Documentation . . . . . .39
  154.      Appendix C: KATASK Batch Menu Facilitator Program . . . . . . . . . . .40
  155.      Appendix D: Provided DBS-KAT Files. . . . . . . . . . . . . . . . . . .41
  156.      Appendix E: Minimum Computer Files Needed To Operate DBS-KAT. . . . . .42
  157.      Appendix F: Why DOS 2.X Users Should Update To DOS 3.2 or DOS 3.3 . . .43
  158.  
  159.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 5
  160.  
  161.  
  162.                                  ABOUT THIS MANUAL
  163.                                  -----------------
  164.  
  165.                                       GENERAL
  166.  
  167.      A section is designated by a centered & underlined heading. Centered but
  168.      NOT underlined headings are referred to as a subsection.
  169.  
  170.      Absolutely, do not use DBS-KAT prior to thoroughly following the
  171.      installation instructions, including restarting your computer after fol-
  172.      lowing the installation instructions.
  173.  
  174.      This manual explains what you minimally need to read in order to use the
  175.      software. After you are comfortable with the program, or if you have
  176.      additional questions, you can print out & read the TECHNICAL REFERENCE
  177.      MANUAL. (Or find "TC".)
  178.  
  179.      Please read each section of this manual before using DBS-KAT. It won't
  180.      take you long.
  181.  
  182.  
  183.                                     TRADEMARKS:
  184.  
  185.      "COMPAQ & COMPAQ PLUS" are trademarks of COMPAQ Corporation.
  186.      "MS-DOS" is a trademark of Microsoft Corporation.
  187.      "PC-DOS & IBM" are trademarks of International Business Machines Corp.
  188.      "PC-WRITE & Quicksoft" are trademarks of Quicksoft.
  189.      "DB-VISTA" is a trademark of RAIMA Corporation.
  190.      "Lattice" is a trademark of Lattice Inc.
  191.  
  192.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 6
  193.  
  194.  
  195.                                         =MO
  196.  
  197.                                    INTRODUCTION
  198.                                    ------------
  199.  
  200.                                      OVERVIEW
  201.  
  202.      DBS-KAT is an easy, practical, super capacity diskette cataloger for
  203.      owners of IBM PC computers & compatibles. Without sacrificing processing
  204.      performance, it can manage up to 9,999 diskettes & 16 million filenames
  205.      in one central database.
  206.  
  207.      Three support & companion programs to DBS-KAT are included on the DBS-KAT
  208.      base system diskette: KATSCAN, KPRINT & KATASK.  KATSCAN is a stand-alone
  209.      program for managing & locating files on a user's hard disk.  KPRINT is a
  210.      print program for programmers.  KATASK is not documented outside of this
  211.      manual, but is a program that enables a user to respond to a menu display
  212.      inside a DOS batch command file.  All of these programs are used by DBS-
  213.      KAT & need to be installed along with the other DBS-KAT software.
  214.      Although this manual explains how to print out the documentation for
  215.      KATSCAN & KPRINT, they are not discussed in this manual.  Appendix C
  216.      documents the KATASK program.
  217.  
  218.      DBS-KAT is primarily aimed at hard disk owners, who utilize floppy dis-
  219.      kettes or removeable disk cartridges.  However, if the hard disk owner
  220.      has a tape device, such as made by ADIC (Advanced Digital Information
  221.      Corp., Redmond, WA), which fools DOS into thinking it is a large dis-
  222.      kette, then DBS-KAT should be able to process the filenames on those tape
  223.      cartridges. If you are able to do so on a non-ADIC made tape drive,
  224.      please report your success to Applied Foresight.
  225.  
  226.      DBS-KAT is 99% written in the C programming language (Lattice C), the
  227.      remainder in Assembler. It uses a run-time royalty-free & license-free
  228.      network model database manager, called DB-VISTA by RAIMA Corporation,
  229.      11717 Rainier Avenue South, Seattle, WA 98178.
  230.  
  231.      Another benefit of DBS-KAT is the printer program included.  KPRINT has
  232.      an abundant number of printer features which makes it ideal for printing
  233.      out source code of programs & other types of plain ASCII files. It has
  234.      gone through over 35 upgrades because of numerous upgrade requests.
  235.      Online help is available by just typing in KPRINT & pressing the ENTER
  236.      key.
  237.  
  238.  
  239.                                PHILSOPHY OF DBS-KAT
  240.  
  241.      DBS-KAT follows the DB-SHAREWARE distribution concept, developed by DBS-
  242.      KAT's author & separately explained in THE DB-SHAREWARE PROGRAM manual.
  243.  
  244.      The purpose of the DBS-KAT software is to maintain a master catalog of
  245.      all diskette filenames that can be inquired against quickly to inform you
  246.      which diskette(s)  contains the filename(s) you are looking for.
  247.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 7
  248.  
  249.  
  250.  
  251.      Simply put, DBS-KAT requires that you physically label all your diskettes
  252.      starting with the label 0001 up through 9999 & that you stack your dis-
  253.      kettes sequentially in numeric order. Although, you are recommended to
  254.      software label these diskettes (DBS-KAT lets you do this while within the
  255.      program; DOS lets you do this with the FORMAT /V or LABEL programs), DBS-
  256.      KAT does not require it & supports cataloging diskettes with or without
  257.      existing volume labels. It makes no difference how unrelated any neigh-
  258.      boring sequenced diskette is, for DBS-KAT will provide the logical orga-
  259.      nization to your diskettes. Then all you have to do is let DBS-KAT "look"
  260.      at each one of your diskettes as they are used.
  261.  
  262.      Simply doing this, DBS-KAT can always tell you quickly where is something
  263.      you want. You can start using your diskettes to contain critically needed
  264.      current files. You can delay updating the hard disk capacity of your com-
  265.      puter. You can start thinking of your diskettes as being as accessible to
  266.      you as another hard disk subdirectory, for you will be able to find out
  267.      directory information about any file you have worked with, regardless of
  268.      whether it is currently on your hard disk or now on a floppy.
  269.  
  270.      The philosophy of DBS-KAT is to make managing your diskette filenames as
  271.      effortless as possible. Once you have installed DBS-KAT, & set up your
  272.      system control record, the minimal amount of typing you have to do in the
  273.      lifetime of a single diskette, while you are inside the DBS-KAT program,
  274.      is to assign a 4 digit ID number, once, to the diskette. Everything else
  275.      is automatically done for you based upon the directory information con-
  276.      tained on the diskette & the default information for diskettes existing
  277.      in the system control record.
  278.  
  279.      (Hint: you're told this below & provided specific syntax examples, but
  280.      don't forget!  If you want to do minimal typing when using DBS-KAT,
  281.      always include the "-n" option when you invoke the KAT.EXE program.)
  282.  
  283.      Alternatively, if you so desire, you can maintain unique information
  284.      about individual diskette volumes. When you run the DBS-KAT program, you
  285.      indicate whether you want to be prompted for manual entry of volume label
  286.      textual information or whether you desire to avoid these prompts & to
  287.      instead have default information apply.
  288.  
  289.  
  290.                           USING DBS-KAT WITH THE IBM AT
  291.  
  292.      The subdirectory which a diskette file may optionally reside in is
  293.      cataloged by DBS-KAT without requiring any action by the user. Many IBM
  294.      AT owners may appreciate this feature.  With the 1.2 MB capacity
  295.      floppies, there is increasing use of making subdirectories on floppies.
  296.      You do not need an IBM AT to make subdirectories on your floppies. Just
  297.      type: MD A:\SUBDIR & press ENTER to create the directory called, \SUBDIR,
  298.      on drive A.
  299.  
  300.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 8
  301.  
  302.  
  303.  
  304.                            DBS-KAT BASE SYSTEM FEATURES
  305.  
  306.      The documentation includes a two page overview page. Everything described
  307.      on the overview page is on this diskette.  This is NOT demo software!
  308.  
  309.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 9
  310.  
  311.  
  312.                                         =MR
  313.  
  314.                                HARDWARE REQUIREMENTS
  315.                                ---------------------
  316.  
  317.                                MINIMUM REQUIREMENTS
  318.  
  319.      You minimally need the following for DBS-KAT:
  320.  
  321.         256K RAM memory free (320 KB RAM available);
  322.         Fixed Hard Disk -- see exception note below;
  323.         80-column monitor;
  324.         MS-DOS or PC-DOS 3.0 or higher (see Appendix F is you have DOS 2.X);
  325.         a CONFIG.SYS file [create or modify yours as instructed in this
  326.          manual];
  327.         IBM PC,XT,AT,PS/2 or compatible
  328.  
  329.      You are advised to have at least 262,144 bytes of RAM or 256K RAM free
  330.      before running DBS-KAT. Therefore, you should have at least 320K RAM
  331.      available. DBS-KAT may run slightly under that amount of RAM free space,
  332.      but you do so at your own risk.
  333.  
  334.  
  335.                                 RECOMMENDED OPTIONS
  336.  
  337.      The following options are recommended.
  338.  
  339.         a computer printer capable of continuous printing & printing 80
  340.            columns per line;
  341.         a RAM disk-emulator (requires additional memory & RAM software) to
  342.            hold frequently called subprograms & run-time, temporary work
  343.            files;
  344.  
  345.      The printer will allow you to use those options which utilize the
  346.      printer. The RAM disk-emulator will not give you any extra features, but
  347.      will provide better performance. If you are a novice DOS 3.00+ user, you
  348.      don't need to immediately worry about what a "RAM disk" is & how to
  349.      create one. Over the weeks or months that you use DBS-KAT, you might want
  350.      to buy a DOS tutorial book, which will educate you about DOS & what a
  351.      "RAM DISK" is. But for now, ignore discussions about "RAM DISKS".
  352.  
  353.      PC-DOS 3.0 supplies the capability to create a RAM disk. If you consider
  354.      yourself past the DOS novice stage, read up on your CONFIG.SYS &
  355.      VDISK.SYS files.
  356.  
  357.  
  358.                                     COMMENTARY
  359.  
  360.      In lieu of a fixed hard disk, if you own an IBM AT with dual floppy
  361.      drives, one of them being a high capacity 1.2 MB disk drive, you could
  362.      conceivably use this software.
  363.  
  364.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 10
  365.  
  366.  
  367.      With the DBS-KAT software, cataloging 200 diskettes & 5,000 filenames
  368.      will require less than 654 KB of space. This 654 KB figure includes the
  369.      DBS-KAT software space requirements.
  370.  
  371.      You may ask: "How will DBS-KAT help me avoid needing extra hard disk
  372.      space if DBS-KAT will swallow so much disk space?"  The answer is that if
  373.      you could rapidly access data files from your diskettes as easy as you
  374.      currently do a DOS DIR command for the location of a desired file & your
  375.      subsequent change to another hard disk directory to access that file
  376.      (else your COPY command against that file residing in the other
  377.      directory), then chances are that you would find yourself with 20-40%
  378.      more free space on your hard disk.
  379.  
  380.      DBS-KAT allows you to offload between 20-40% of your hard disk space,
  381.      which is probably now eaten up by moderately or infrequently accessed
  382.      data files, on to floppies. You can leave your hard disk to keep
  383.      executeable programs & required companion files (e.g., program Help or
  384.      Screen files), as well as constantly accessed data files or databases.
  385.      You are advised to always offload files twice to different diskettes
  386.      before deleting these files on your hard disk.
  387.  
  388.      There are other reasons for DBS-KAT, which offset the disk space that
  389.      DBS-KAT imposes. These other reasons are rapid access to archived files &
  390.      prior version files. If you acquire the add-on software modules, you'll
  391.      have additional reasons to put up with the slight loss of hard disk space
  392.      because of DBS-KAT. Type KAT -O for a printout about the add-on software
  393.      modules.
  394.  
  395.  
  396.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 11
  397.  
  398.  
  399.                                       =MI =QK
  400.  
  401.                                    INSTALLATION
  402.                                    ------------
  403.  
  404.  
  405.                                      OVERVIEW
  406.  
  407.      Installation requires that you configure your operating system
  408.      environment to satisfactorily accomodate database management processing &
  409.      that you install the software on your hard disk.
  410.  
  411.      For those users who understand DOS well & are impatient to proceed on to
  412.      the next section, I'll state the installation procedure fast. If you
  413.      don't know what is being talked about, skip the following subsection &
  414.      print out & refer to the accompanying manual, INSTALLATION FOR NEW COM-
  415.      PUTER USERS (find "NC"). In that manual, you'll be walked through the
  416.      installation procedure step-by-step, slowly.
  417.  
  418.      If this is the first section you're reading (you did a find "QK" for
  419.      instance), please also read the introduction & philosophy subsections so
  420.      that you won't be confused by running before reading about DBS-KAT.  To
  421.      read these two subsections now, press "Home" then find "MO".  After
  422.      you've read them, return to here & read down through the next subsection
  423.      about installing DBS-KAT.  Finally, review the crib-sheet page (press
  424.      "home" then find "CR").
  425.  
  426.      Appendix E lists the files which the install process has you put on your
  427.      drive.  If you want to delete the DBS-KAT install files from your hard
  428.      disk, position your cursor in the same directory on your hard disk where
  429.      you installed DBS-KAT & type:
  430.          DEL  DBSKAT.EXE   & press ENTER.
  431.          DEL  READ.ME      & press ENTER.
  432.  
  433.      If you have problems installing, or with DBS-KAT, refer to the section in
  434.      this manual, "Trouble Shooting Tips."  (find "ME".)
  435.  
  436.  
  437.                           SHORT INSTALLATION INSTRUCTIONS
  438.                          FOR THE DOS 3.0+ EXPERIENCED USER
  439.  
  440.      Installation requires the following specific acts (assume drive A is a
  441.      floppy & drive C is a hard disk).  It is assumed that you have installed
  442.      the DBSKAT.EXE program into a directory on your fixed disk, called
  443.      \DBSKAT, & that you have executed this program to create the DBS-KAT
  444.      files & documentation.
  445.  
  446.         1.  You are highly recommended to put your KATDB.* files in the sub-
  447.             directory, \DBSKAT. If you put them in any other subdirectory,
  448.             then you must always invoke a DBS-KAT program with a -L option &
  449.             be sitting in that directory at run time. Specific syntax examples
  450.             are given later. (If you install the KATDB.* files in the root
  451.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 12
  452.  
  453.  
  454.             directory, DBS-KAT will detect that without you having to first
  455.             move their as well.)
  456.  
  457.             Putting the KATDB.* files in \DBSKAT, means that you can be any-
  458.             where on your hard disk & from that location run DBS-KAT. However,
  459.             if you install the DBSKAT programs there, this assumes that you
  460.             have a PATH statement which minimally encompasses the \DBSKAT
  461.             directory. The following PATH statement might be a typical path
  462.             statement to use:
  463.                PATH=C:\;C:\DOS;C:\UTIL;C:\DBSKAT
  464.  
  465.             If you need to create or update your PATH statement, include the
  466.             PATH command line (such as the above) in your C:\AUTOEXEC.BAT
  467.             file. If you don't have a C:\AUTOEXEC.BAT file, then minimally
  468.             create one which looks like the one below. Use any editor which
  469.             can update a plain vanilla ASCII file (e.g., EDLIN, PC-WRITE, EC).
  470.             The PROMPT line is optional. It will show you to the left of the
  471.             prompt sign, your current directory area. A minimal
  472.             C:\AUTOEXEC.BAT file should include:
  473.                DATE
  474.                TIME
  475.                PATH=C:\;C:\DOS;C:\UTIL;C:\DBSKAT
  476.                PROMPT ($P)
  477.  
  478.             If you are DOS 1.1 experienced, the filename "C:\MYFILE", means a
  479.             file, of the name "MYFILE" which resides in the root directory "\"
  480.             of drive "C:". If your cursor is positioned already in the root
  481.             directory of C:, then you can ignore the "\" symbol.
  482.  
  483.         2.  Put the remaining DBS-KAT diskette files somewhere along your PATH
  484.             (or \DBSKAT if you've updated your PATH statement). Include in
  485.             your path, your DOS programs, BACKUP, RESTORE, SORT, MORE &
  486.             FORMAT. (I suggest these programs & your path support them in a
  487.             directory called \DOS.)  If you don't have or want a PATH
  488.             statement in your environment, put all of the DBS-KAT & DOS files
  489.             needed in \DBSKAT.
  490.  
  491.         3.  Either create, update, or verify that your C:\CONFIG.SYS file
  492.             exists & has the following two lines in it:
  493.                FILES=20
  494.                BUFFERS=15
  495.             If you have an IBM AT, you could make the BUFFERS=25 instead.
  496.             The BUFFERS line is not needed by DBS-KAT, but since you're
  497.             changing CONFIG.SYS, you might as well optimize your BUFFERS line.
  498.  
  499.         4.  This is an optional step & not required. If you don't have a RAM
  500.             disk, proceed to step 6.
  501.  
  502.             If you have a RAM disk, which is uploaded with files at power up
  503.             time with file copying going on in your C:\AUTOEXEC.BAT file, con-
  504.             sider putting the following files in your RAM disk. This is not
  505.             required, but will give you performance improvement. The files
  506.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 13
  507.  
  508.  
  509.             include SORT.EXE, which comes on your DOS diskette. The files that
  510.             you should consider putting in your RAM disk are:
  511.                SORT.EXE
  512.                KATSCAN.EXE
  513.  
  514.             Consider leaving spare space on your RAM disk of at least 30,000
  515.             bytes. This empty space can be used by DBS-KAT for its run-time,
  516.             temporary work files. The names of these run-time files are
  517.             KATWORK1.DIR & KATWORK2.DIR. You may have to update your
  518.             C:\CONFIG.SYS if your RAM disk space alottment is done in that
  519.             file. If you use IBM AT high capacity floppies & store a high
  520.             number of files on them, you may need to allocate more than 30,000
  521.             bytes to accomodate these work files.
  522.  
  523.             Put the drive designation for your RAM disk at the start of the
  524.             left hand side of your PATH statement, so that your RAM disk gets
  525.             looked at first down your PATH. If drive D is your RAM disk, then
  526.             minimally your PATH statement should include:
  527.                PATH=D:\;C:\;C:\DOS;C:\UTIL;C:\DBSKAT
  528.  
  529.             To avoid DOS executing these two programs from your hard disk,
  530.             make sure that SORT.EXE & KATSCAN.EXE will not exist in any PATH
  531.             directory other than D:\, nor let them exist in the current
  532.             directory where you have your DBS-KAT database.  Consider creating
  533.             a directory called \OFFPATH & moving these two files there.  In
  534.             your \AUTOEXEC.BAT file copy the \OFFPATH directory to your RAM
  535.             disk.
  536.  
  537.         5.  If you updated CONFIG.SYS or AUTOEXEC.BAT, restart your computer
  538.             now.  DO NOT SKIP THIS STEP!
  539.  
  540.             [The following find code is here for novice users who are told to
  541.             "jump" back to here.  =M6]
  542.  
  543.         6.  Excepting those with less than 100% IBM PC Compatibility
  544.             (including those who use a Hercules monochrome/graphics card) or
  545.             those who power on their computer with a startup diskette, you can
  546.             go to the next section, "Updating The DBS-KAT System Control
  547.             Record." (find "MS".)  Quick quide users (who find "QK") should
  548.             quickly read this next section before attempting to use DBS-KAT
  549.             without further manual reading.
  550.  
  551.             Those whose computers are neither IBM nor as compatible to an IBM
  552.             as a COMPAQ is, should read the next subsection before proceeding
  553.             to the next section. Those who use a startup diskette should read
  554.             the section immediately following.
  555.  
  556.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 14
  557.  
  558.  
  559.  
  560.                                         =MH
  561.  
  562.                    INSTALLATION FOR NON-IBM COMPATIBLE MS-DOS PC
  563.                        OR ANY BRAND PC WITH A HERCULES CARD
  564.  
  565.      The author has not tested this software on non-IBM compatible MS-DOS com-
  566.      puters. It was developed on a COMPAQ PLUS computer however. The rapid
  567.      display of DBS-KAT's signon & usage screen is the most IBM specific piece
  568.      of code knowingly used. As said, this does work on a COMPAQ PLUS.
  569.      However, it might not work on less compatible MS-DOS computers. For sure,
  570.      the default fast screen method does not work with a Hercules
  571.      Monochrome/Graphics Card (even with an IBM PC!).  For this reason, the
  572.      user can disable this direct IBM-type screen use.
  573.  
  574.      To do this, type in the following, with your prompt at the "C" level.
  575.      Type:   ECHO  X>\IAMNOTAN.IBM   & press the ENTER key. This is all you
  576.      have to do. What you've done is create a one byte file in your root
  577.      directory of your hard disk. The drive must be the same as the drive
  578.      where your database resides. DBS-KAT will utilize a less machine specific
  579.      screen display method if it finds this file to exist.
  580.  
  581.  
  582.                                         =MF
  583.  
  584.                 ADDITIONAL INSTALL INFORMATION FOR HARD DISK USERS
  585.                 WHO POWER ON THEIR COMPUTER WITH A STARTUP DISKETTE
  586.  
  587.      1. These instructions will assume that drive A is your floppy & that
  588.         drive C is your hard disk. Also assumed is that during your following
  589.         the installation instructions, that you inspected, & if needed,
  590.         updated the CONFIG.SYS & AUTOEXEC.BAT on a bootup floppy diskette.
  591.         Insert your bootup floppy in drive A. Make sure you don't have a
  592.         write-protect tape on your floppy. If so, temporarily remove it.
  593.  
  594.      2. Type: COPY A:COMMAND.COM C:\/V & press ENTER. If you ever update your
  595.         operating system, be sure to repeat this operation with the new
  596.         COMMAND.COM.
  597.  
  598.      3. You must add a "SET COMSPEC" line to your AUTOEXEC.BAT file first so
  599.         that DBS-KAT will think you powered on off your hard disk. Do the
  600.         below:
  601.         3.A.  At the "C" prompt, type: EDLIN A:AUTOEXEC.BAT
  602.         3.B.  At the "*" EDLIN prompt, type: I
  603.         3.C.  Type: SET COMSPEC=C:\COMMAND.COM
  604.         3.D.  Press the F6 function key & press ENTER.
  605.         3.E.  Type: E
  606.  
  607.      4. Restart your computer now, using your updated bootup floppy disk. If
  608.         you have a backup of your bootup floppy disk, make sure the backup
  609.         gets the new AUTOEXEC.BAT put on it. You must do this restart of your
  610.         computer in order for DBS-KAT to work correctly.
  611.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 15
  612.  
  613.  
  614.  
  615.  
  616.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 16
  617.  
  618.  
  619.                                         =MS
  620.  
  621.                     UPDATING THE DBS-KAT SYSTEM CONTROL RECORD
  622.                     ------------------------------------------
  623.  
  624.      Before you can regularly use DBS-KAT to process & inquire against dis-
  625.      kettes, you must first update DBS-KAT's System Control Record, which
  626.      keeps track of your database as well as holding your default value
  627.      entries.
  628.  
  629.      This manual explains the program prompts. You can then actually update
  630.      your system control record, taking mostly the default values, except
  631.      where it is obvious that you should over-ride the provided default. If
  632.      you update your system control record after reading this section, come
  633.      back to this manual & read the remaining sections before using the rest
  634.      of DBS-KAT's features.
  635.  
  636.      You minimally only need to update your system control record during DBS-
  637.      KAT's install process. The program used to update the system control
  638.      record is a subprogram within the inquiry program, KATLOOK.EXE.
  639.  
  640.      To perform this, you should be somewhere on your "C" drive with your
  641.      prompt ready to receive a command. Either type: KATLOOK -M & press ENTER
  642.      or type: KAT -M & press ENTER. Don't forget the minus sign (hereafter
  643.      called the "dash") if you type: KAT -M. Typing KATLOOK -M will actually
  644.      load the program faster, as the other method first loads the KAT program
  645.      which in turns loads KATLOOK with the "-M" option.
  646.  
  647.      If you installed DBS-KAT in a subdirectory, type either KATLOOK -ML or
  648.      KAT -ML.
  649.  
  650.      After receiving a logo display, you'll get the message "No System Control
  651.      Record, --Putting you into add mode."  You'll be prompted for a variety
  652.      of fields, in each case you'll be shown the allowed maximum width of your
  653.      answer. In some cases, you'll be shown a default answer you'll get if you
  654.      just press ENTER. The prompts that you will be shown are reproduced
  655.      below. Supporting comments are provided, when needed, alongside.
  656.  
  657.      Alternatively, if you have previously added a System Control Record,
  658.      you'll be put in the update mode where the prompts are so similar, that
  659.      they do not needed to be documented here. However, you are not allowed by
  660.      this program to update the database owner's name, once you insert it into
  661.      your database. This is because of the security arrangement of DB-
  662.      SHAREWARE, -see the manual on DB-SHAREWARE for more information.
  663.  
  664.      When DBS-KAT is done processing the system control record, your database
  665.      is closed & you are exited back to the DOS prompt.
  666.  
  667.      For the current software release of DBS-KAT, you are unable to change the
  668.      database owner's password, which is the password needed to change the
  669.      user's password. The reason for this is unrelated to security reasons, &
  670.      if enough users request it, the ability to change this password will be
  671.      allowed in a future release.
  672.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 17
  673.  
  674.  
  675.  
  676.      However, if you misspell your name or the database owner's password, you
  677.      are allowed at the end of the system control add function to start the
  678.      add process over again. Once you've added the system control record, then
  679.      unless you want to start again with a totally empty database, you will be
  680.      unable to change these two fields again using this program.
  681.  
  682.      You can update the database owner's name, by ordering an add-on software
  683.      module, because on the order form (type: KAT -O), you specify the new (or
  684.      same) database owner's name which the add-on software program will use to
  685.      update your old database.
  686.  
  687.      All prompts require a response except where specified as "optional."
  688.      When you are given a default response (shown above the allocated space
  689.      for your answer), you can take the default response by just pressing the
  690.      ENTER key.
  691.  
  692.      Many of these prompts will be repeated during each diskette you process,
  693.      unless you chose at run time to have DBS-KAT skip prompting you & to
  694.      instead use the default answers set up in the system control record.
  695.      These prompts which are capable of being repeated for each diskette being
  696.      processed have the parenthetical statement "(for diskette vol. info.)"
  697.      shown beneath the prompt. At run time, the actual wording of the prompts
  698.      may in some cases be up to 10 percent longer. For space reasons, they are
  699.      shortened here to allow more space for the right hand commentary.
  700.  
  701.      PROMPT -----------------   COMMENT---------------------------------------
  702.  
  703.      Database Owner's Name      You are required to enter your name or that of
  704.                                 your company. This name will be shown to you
  705.                                 each time that you run DBS-KAT in the manner
  706.                                 described in the DB-SHAREWARE manual.
  707.  
  708.                                 This field is the only field which will
  709.                                 preserve lower case input. All other fields in
  710.                                 DBS-KAT will upper case your input as it is
  711.                                 stored in the database.
  712.  
  713.      Database User Password     The only place that DBS-KAT can optionally
  714.      (optional)                 have a security concern is in the inquiry
  715.                                 function & password maintenance function.
  716.                                 Anyone can always update your database (except
  717.                                 the password portion).
  718.  
  719.                                 The thinking behind this decision is that you
  720.                                 might have your secretary or assistant update
  721.                                 your database as they update your diskettes.
  722.                                 However, if you have hundreds of diskettes,
  723.                                 you might have some of them devoted to con-
  724.                                 fidential topics, which might be revealed in
  725.                                 their file name or volume (DBS-KAT entered)
  726.                                 heading. You might want the location of these
  727.                                 diskettes hidden.
  728.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 18
  729.  
  730.  
  731.  
  732.                                 Thus you can ask that DBS-KAT checks for a
  733.                                 user password (which you set up) of anyone
  734.                                 asking to inquire against the database.
  735.  
  736.      Password to chg password   Since you may allow more than yourself the
  737.      (optional)                 right to inquire into your database & you may
  738.                                 later change your mind about another person's
  739.                                 right to look into your data base, a password
  740.                                 beside the user password was needed. Consider
  741.                                 this the owner's or administrator's password.
  742.  
  743.                                 IMPORTANT! Do not ever forget this password!
  744.                                 If you forget it, there is no way you can use
  745.                                 either the existing DBS-KAT software or
  746.                                 DEBUG's dump command to uncover this password.
  747.                                 A proprietary encryption method stores this
  748.                                 password in your database. Use a password that
  749.                                 is impossible for you to forget, yet which is
  750.                                 one others won't ever guess, such as a
  751.                                 childhood nickname no longer used, or your
  752.                                 first date's name, etc. You may want to write
  753.                                 your password down & store it in your safe or
  754.                                 safety deposit box.
  755.  
  756.                                 Note: if you decide not to implement this
  757.                                 administrator's password during the initial
  758.                                 add system control process, you are never
  759.                                 given the opportunity to change your mind.
  760.  
  761.                                 If you aren't excited about requiring a
  762.                                 password at inquiry time, you might want to
  763.                                 implement an administrator password, but skip
  764.                                 for the time being a user password. If you
  765.                                 know the administrator password, you can
  766.                                 always assign a new user password via the
  767.                                 update system control process.
  768.  
  769.      Default loc: H(ome)/W(ork) The default location is W(ork).  You can
  770.                                 change the default location to H(ome).  See
  771.                                 next prompt for more information.
  772.  
  773.      Enter begin no. for home   The default number is 0001. DBS-KAT allows
  774.                                 designating the location of your diskettes to
  775.                                 be either at work or at home. Some of the DBS-
  776.                                 KAT users may be using a portable & thereby be
  777.                                 tracking diskettes at both locations.
  778.  
  779.                                 The purpose of this field is to save you key-
  780.                                 strokes in assigning the volume ID for your
  781.                                 diskette. You are always allowed to over-ride
  782.                                 the prompted default value.
  783.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 19
  784.  
  785.  
  786.  
  787.      Enter begin no. for work   The default number is 5001.
  788.  
  789.      # of disk upds b4 sugg.bu  Because DBS-KAT involves a database, you are
  790.                                 suggested to periodically back up your
  791.                                 database, in case unpredicatible interrup-
  792.                                 tions, whether hardware or otherwise caused,
  793.                                 destroy your database. At the start of each
  794.                                 diskette to be processed, you are given the
  795.                                 option to backup the database. However, you
  796.                                 may decide to methodically back up the
  797.                                 database every so many diskettes. If you
  798.                                 desire a periodic reminder, insert the desired
  799.                                 interval here, otherwise assign a very high
  800.                                 number (e.g., 99).
  801.  
  802.      Enter diskette drive char  Typically, you'll probably choose the default
  803.                                 letter, A. However, you can choose any legit-
  804.                                 imate floppy disk drive, or drive which acts
  805.                                 to DOS like a floppy disk drive (refer to
  806.                                 earlier comments in the Hardware Requirements
  807.                                 Section).
  808.  
  809.                                 If you have an IBM AT, & alternate between
  810.                                 drive A & B, you should pick the letter used
  811.                                 the most often. You are given the opportunity
  812.                                 inside the cataloging program to over-ride
  813.                                 this letter.
  814.  
  815.      Enter KATWORK1.DIR drive   DBS-KAT during its processing of a diskette,
  816.      ENTER KATWORK2.DIR drive   will run another program, KATSCAN.EXE, which
  817.                                 creates a directory display file of your
  818.                                 entire diskette, even if it has subdirectory-
  819.                                 located files on it. The unsorted directory
  820.                                 display file is called KATWORK1.DIR. DBS-KAT
  821.                                 then runs your DOS program, SORT.EXE, against
  822.                                 this KATWORK1.DIR file & outputs the sorted
  823.                                 version of this file under the name
  824.                                 KATWORK2.DIR. If you have an electronic RAM
  825.                                 DISK, indicate its drive letter here. The
  826.                                 default drive letter is the typical hard drive
  827.                                 letter, C.
  828.  
  829.                                 If you will alternate cataloging diskettes &
  830.                                 removeable disk cartridges, setup the system
  831.                                 control record with the parameters you want
  832.                                 for the diskette drive. Using the "S" option
  833.                                 in the catalog update process (KAT -U), you
  834.                                 can switch to cataloging your removeable disk
  835.                                 cartridges & the program will let you change
  836.                                 for the session (or until you choose the "S"
  837.                                 option again, whichever comes first) the para-
  838.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 20
  839.  
  840.  
  841.                                 meter settings for the: (a) target drive being
  842.                                 cataloged, (b) drive to use for work files,
  843.                                 (c) & sector size of device being cataloged.
  844.  
  845.      Default From Hd Drive      Typically this is drive C, the default. If
  846.      (for diskette vol. info.)  you ask DBS-KAT to prompt you for each dis-
  847.                                 kette being processed, you'll be prompted for
  848.                                 the source hard disk drive, & be given this
  849.                                 letter as the default answer.
  850.  
  851.      Default vol. pathname      The default hard disk source pathname for your
  852.      (for diskette vol. info.)  diskette file is "VARIES". If you catalog a
  853.                                 diskette with no files on it, & you've asked
  854.                                 not to be prompted for volume heading
  855.                                 information, DBS-KAT substitutes a blank
  856.                                 pathname.
  857.  
  858.                                 The idea behind the pathname is to have the
  859.                                 inquiry function act similar to how you inter-
  860.                                 rogate your directory on your hard disk. On
  861.                                 your hard disk, you'll typically move yourself
  862.                                 to a directory, & then query a file set
  863.                                 against only that directory.
  864.  
  865.                                 For example, if you are in a directory for
  866.                                 your word processing files, the DIR *.DOC will
  867.                                 scope word processing files, whereas if you
  868.                                 have a directory for your programming devel-
  869.                                 opment, the DIR *.DOC might scope program
  870.                                 development or usage documentation files.
  871.  
  872.                                 However, to minimize database overhead both to
  873.                                 reduce disk space utilization & update pro-
  874.                                 cessing time, the directory database is not
  875.                                 structurally segmented by pathname. Doing an
  876.                                 inquiry similar to a DIR *.DOC against your
  877.                                 \WORK directory, will involve scanning your
  878.                                 database from the very first record through
  879.                                 the very last record. Thus, you'll probably
  880.                                 want to minimize inquiries where the leading
  881.                                 characters of the filename are irrelevant.
  882.  
  883.      Default vol. note          This is a 13 character field, which can be
  884.      (for diskette vol. info.)  thought of being a commentary field on the
  885.                                 diskette's contents or a place for extended
  886.                                 path information, in case your source hard
  887.                                 disk pathname is longer than 8 characters long
  888.                                 (e.g., \LOTUS\TEMPLATE\DOC).  Examples of
  889.                                 appropriate comments might be "NORTON UTILS",
  890.                                 "XTALK" or "LOTUS".
  891.  
  892.                                 The default note for your diskette volume
  893.                                 heading is "MISC". If you catalog a diskette
  894.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 21
  895.  
  896.  
  897.                                 with no files on it, & you've asked not to be
  898.                                 prompted for volume heading information, DBS-
  899.                                 KAT substitutes "SCRATCH" for the volume
  900.                                 heading note.
  901.  
  902.      Default YY+Qtr buy disk    You might want to keep track of how old a
  903.      (for diskette vol. info.)  diskette is. The default answer, zero, will
  904.                                 substitute the current YEAR & QUARTER (con-
  905.                                 catenated together as a 3 digit number). When
  906.                                 first entering in all your old diskettes, if
  907.                                 they are on the average 9 months ago, you
  908.                                 might want to indicate the YY+Qtr for that
  909.                                 period. Then after your initial database load,
  910.                                 you could change the default value back to
  911.                                 zero.
  912.  
  913.      Diskette Format OP SYS     Indicate here the default for whether the
  914.      (for diskette vol. info.)  diskette is normally formatted under IBM PC
  915.                                 DOS ('P'), which is the default, or under MS
  916.                                 DOS ('M').
  917.  
  918.                                 These letters do not cause anything special to
  919.                                 happen, except that they will be redisplayed
  920.                                 on some screen outputs. You can use
  921.                                 alternative letters if you wish.
  922.  
  923.      OP SYS Ver. (no dec.pt.)   Indicate here the default for which DOS
  924.      (for diskette vol. info.)  version number, the diskette was formatted
  925.                                 under, however do not use a decimal point
  926.                                 (wasted storage & display space to carry the
  927.                                 decimal). Thus 200, the default, refers to
  928.                                 2.00 DOS.
  929.  
  930.      Usual seq_typ is           You may be processing a group of related
  931.      (for diskette vol. info.)  diskettes. The grouping may be because you are
  932.                                 using the DOS BACKUP command (type 'B'), which
  933.                                 is the default or because you are cataloging a
  934.                                 software package containing more than one dis-
  935.                                 kette (type 'P').
  936.  
  937.                                 You are free to invent other sequence types.
  938.                                 However, use 'B' for the DOS BACKUP sequence
  939.                                 type. Future software may act upon this
  940.                                 information.
  941.  
  942.                                 For now, just indicate, that when you are pro-
  943.                                 cessing a sequence of diskettes, what will be
  944.                                 the normal sequence type. Don't worry if most
  945.                                 of the time you will not be processing a
  946.                                 sequence of diskettes.
  947.  
  948.      Disk usually part of set   Indicate 'Y' or 'N' (the default), whether the
  949.                                 normal diskette you intend to catalog will
  950.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 22
  951.  
  952.  
  953.                                 belong to a sequentially related set of dis-
  954.                                 kettes, such as a full backup set, etc.
  955.  
  956.      Enter DOS cmd for B/U      You are highly recommended to perform your PC
  957.                                 KAT database backup under DBS-KAT supervision.
  958.                                 The default method is via the DOS BACKUP
  959.                                 command ("BACKUP C:\KATDB.* A:"). You can
  960.                                 insert any valid DOS command here to
  961.                                 accomplish your backup. Your DOS command could
  962.                                 even be the .BAT file name to do your backup
  963.                                 (leave out the ".BAT").
  964.  
  965.                                 The database will be updated that you are
  966.                                 about to do a backup, then the database will
  967.                                 be closed prior to your backup. Also, your
  968.                                 DBS-KAT log file will note the occurrence of a
  969.                                 backup being performed. More about this log
  970.                                 file later in the manual.
  971.  
  972.      Enter label utility name   The default answer should suffice, since DOS
  973.                                 3.0 or greater is required & it comes with the
  974.                                 DOS LABEL program.  If you don't have LABEL,
  975.                                 you can enter the word "VOLSER" in this field.
  976.                                 In addition, some versions of Norton's Util-
  977.                                 ities comes with the program, LABEL. Make your
  978.                                 choice known to DBS-KAT.
  979.  
  980.                                 For those who don't have a DOS LABEL program,
  981.                                 DBS-KAT comes with a free, user group program,
  982.                                 VOLSER Version 2.00, Copyright 1983 by T. A.
  983.                                 Davis. As T. Davis does not provide an address
  984.                                 Applied Foresight is unable to ask his
  985.                                 permission or to ask users of DBS-KAT to vol-
  986.                                 untarily contribute an appreciation token to
  987.                                 Mr. T. A. Davis. VOLSER is a label utility.
  988.  
  989.                                 With the software label utility you choose
  990.                                 here, you can update your diskette with the
  991.                                 volume ID four digit number (use leading zeros
  992.                                 to make the volume ID 4 digits). Having the
  993.                                 volume ID software embedded onto the diskette,
  994.                                 saves DBS-KAT from having to ask you each time
  995.                                 what is the number on the sticky label outside
  996.                                 your diskette. Oh yes, you should have a four
  997.                                 digit volume ID on a sticky label outside your
  998.                                 diskette.
  999.  
  1000.      Entries Okay               The default answer is 'Y' for Yes. If you want
  1001.                                 to change one of your answers made above, you
  1002.                                 should answer 'N' for No. You'll be reprompted
  1003.                                 for every field again, starting from the first
  1004.                                 prompt.
  1005.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 23
  1006.  
  1007.  
  1008.  
  1009.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 24
  1010.  
  1011.  
  1012.                                         =MD
  1013.  
  1014.                                CATALOGING DISKETTES
  1015.                                --------------------
  1016.  
  1017.                                  INVOKING DBS-KAT
  1018.  
  1019.      Efficient & rewarding use of DBS-KAT involves continually keeping your
  1020.      database up to date about the contents of all of your diskettes. This is
  1021.      done by the diskette cataloger program function, which can be invoked in
  1022.      a variety of ways. You can enter the commands in upper or lower case, it
  1023.      makes no difference. These commands are entered at the DOS prompt level.
  1024.  
  1025.      INVOKE CMD   COMMENT-------------------------------------------------
  1026.  
  1027.      KAT -U       Catalog diskettes until requested to exit or backup my
  1028.                   database. Provide prompts, with defaults shown, to add or
  1029.                   update unique diskette volume information.
  1030.  
  1031.      KAT          Same as above, except first show program options help page.
  1032.                   Check if program has been installed & the System Controlled
  1033.                   record has been updated.  Exit with message if not installed
  1034.                   yet.  When user responds to "Press any key", process as if
  1035.                   user had typed "KAT -U".
  1036.  
  1037.      KAT -UH      Same as above, except prespecified location is Home.  If
  1038.                   location is not specified, use default location given in the
  1039.                   System Control Record setup.
  1040.  
  1041.      KAT -UW      Same as above, except prespecified location is Work.
  1042.  
  1043.      KAT -U2      Same as KAT -U, except only process for two diskettes.
  1044.  
  1045.      KAT -U2H     Same as KAT -UH, except only process for two diskettes.
  1046.  
  1047.      KAT -UN      Same as KAT -U, except bypass prompting for unique diskette
  1048.                   volume information. Use the default values based upon the
  1049.                   system control record.
  1050.  
  1051.                   For those users who habitually name their files in such a
  1052.                   manner that just remembering the spelling of part or all of
  1053.                   the file name is all that is necessary to know about, those
  1054.                   users might be satisfied running DBS-KAT this way. It saves
  1055.                   about 30-60 seconds per processed diskette, to use the -N
  1056.                   option.
  1057.  
  1058.                   Alternatively, on many of your diskettes, you might want to
  1059.                   not use the -N option. For instance, you might want to state
  1060.                   that the involved diskette belongs to the path, UTIL, & in
  1061.                   the note field, state "PC-TALK III", & so forth. However,
  1062.                   some users, lazy like the Author, might not care about
  1063.                   volume heading information, & rely upon the fact that on
  1064.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 25
  1065.  
  1066.  
  1067.                   this diskette, retrieving by the file name, "PC-TALK", will
  1068.                   always enable DBS-KAT to tell me which diskette volume to
  1069.                   look for PC-TALK III.
  1070.  
  1071.                   On diskettes which habitually get reused for totally dif-
  1072.                   ferent file storage purposes, you might want to always use
  1073.                   the -N option.
  1074.  
  1075.                   While inside DBS-KAT, you can toggle having this "N" option
  1076.                   on or off.
  1077.  
  1078.      KAT -UNH     Same as KAT -UN except prespecified Home as the location.
  1079.  
  1080.      KAT -U2NH    Same as KAT -UNH, except only process for two diskettes.
  1081.  
  1082.      KAT -UA      Same as KAT -U, except floppy to process is on drive A:,
  1083.                   regardless of what drive letter the system control record
  1084.                   points to.
  1085.  
  1086.      KAT -UB      Same as KAT -U, except floppy to process is on drive B:,
  1087.                   regardless of what drive letter the system control record
  1088.                   points to.
  1089.  
  1090.      KAT -LU      Same as KAT -U, except use the database in the current
  1091.                   directory. Without the -L option, DBS-KAT will move to the
  1092.                   root (\) directory to process a database there. If a
  1093.                   database isn't there, but one is in the current directory,
  1094.                   it will remain in the current directory.
  1095.  
  1096.      The user can invoke DBS-KAT using valid combinations of the above. Of
  1097.      course, -A & -B can never be used together. Nor can -H & -W ever be used
  1098.      together.
  1099.  
  1100.      The order in which the options are stated are irrelevant, except that
  1101.      only a number can follow the -U option, immediately to the right of the
  1102.      "U". Thus, typing KAT -UN & KAT -NU will perform the same thing. Some of
  1103.      the above options can be chosen from a menu which drives the program.
  1104.      This menu is shown in the "CATALOGING PROCEDURE" subsection below.
  1105.  
  1106.  
  1107.                           DISKETTE HANDLING WITH DBS-KAT
  1108.  
  1109.      You should physically & software label all your diskettes with a four
  1110.      digit number. Write-protected diskettes need not be software labeled. A
  1111.      physically labeled diskette means that with a soft felt tip pen, you have
  1112.      written a four digit number which is visible on the diskette gum label
  1113.      which sticks on the outside of the diskette. A software labeled diskette
  1114.      means that when you do a DOS DIR A: against the diskette, that you are
  1115.      shown something like the below as the first two lines of the display:
  1116.       Volume in drive A is 0175
  1117.         Directory of A:\
  1118.  
  1119.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 26
  1120.  
  1121.  
  1122.      DBS-KAT provides you with means to do software labeling from inside the
  1123.      cataloging program. Refer back to the last prompt in the System Control
  1124.      Record. The recommended route is to use the numbers 0001-5000 for dis-
  1125.      kettes initially cataloged at Home, & to use the numbers 5001-9999 for
  1126.      diskettes initially cataloged at Work. If you only have one location,
  1127.      then use the numbers 0001-9999. These are only recommendations. Blank
  1128.      volume ID labels or non-4-digit volume ID labels should be minimized to
  1129.      write-protected diskettes, because each time you catalog the diskette,
  1130.      you have to remind DBS-KAT of the volume label number. Diskettes which
  1131.      are 4-digit software labeled, are automatically recognized by DBS-KAT as
  1132.      to what volume label ID it contains.
  1133.  
  1134.      In your diskette containers, you should stack all your diskettes sequen-
  1135.      tially in numeric order. It makes no difference how unrelated any neigh-
  1136.      boring sequenced diskette is, for DBS-KAT will provide the logical orga-
  1137.      nization to your diskettes. However, you'll still find it convenient to
  1138.      keep sequentially logically related diskettes in sequential numeric
  1139.      order, such as for full hard disk backups, etc. The author reserves three
  1140.      neighboring numbered diskettes for his database backups, since with its
  1141.      some 13,400 plus filenames, it goes a little into the third diskette to
  1142.      back up a database this big. Doing this is a convenience not a necessity,
  1143.      for the diskette volume inquiry process will remind you of what follows
  1144.      or precedes a diskette (assuming you told DBS-KAT about the sequencing
  1145.      originally).
  1146.  
  1147.      A "scratch" diskette is one which is either empty of files, or one which
  1148.      has junk or obsolete files on them & can be erased without worry. When
  1149.      DBS-KAT processes a scratch diskette, it labels the database volume
  1150.      header with the word "SCRATCH."  You can ask DBS-KAT for a screen or
  1151.      printout of your SCRATCH volumes. However, if you don't want to have to
  1152.      run this inquiry to find out where your scratch diskettes are, you could
  1153.      consider temporarily locating your scratch diskettes in a scratch dis-
  1154.      kette container or separate location.
  1155.  
  1156.  
  1157.                              THE CATALOGING PROCEDURE
  1158.  
  1159.      The cataloging program is menu driven & your choices for action are dis-
  1160.      played as follows:
  1161.  
  1162.      -------------------------------------------------------------------------
  1163.      OPT: DESCRIPTION                     OPT: DESCRIPTION
  1164.  
  1165.      P   Insert diskette now to PROCESS   E   EXIT program now
  1166.      H   change location to HOME          W   change location to WORK
  1167.      V   change database VOLUME header    L   change diskette volume LABEL
  1168.      D   diskette dir/w & DEL option      F   FORMAT a diskette
  1169.      T   TOGGLE vol hdr prompting on/off  S   SWITCH to another diskette drive
  1170.      B   BACKUP database & exit program
  1171.  
  1172.      PARMS ON: Locn=> HOME; Prompting=> ON; Directory=> ROOT; Floppy=> A:
  1173.                                      P
  1174.      Do: B,D,E,F,H,L,P,S,T,V,W ?    > <
  1175.      -------------------------------------------------------------------------
  1176.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 27
  1177.  
  1178.  
  1179.  
  1180.      Most of the prompts & activity occurring in the cataloging procedure is
  1181.      self evident, based upon the user understanding the system control record
  1182.      update process & being able to read the cataloging procedure displays &
  1183.      prompts.
  1184.  
  1185.      This documentation will cover the portions of this procedure which may
  1186.      not be completely self-evident.
  1187.  
  1188.      1.  In the overview section, DBS-KAT was discussed being smart enough to
  1189.          know that you hadn't made any changes since your last cataloging
  1190.          process against that diskette. There is one ramification to this
  1191.          smartness. If your only change to a previously processed diskette, is
  1192.          that you renamed a file, then DBS-KAT will not process the diskette,
  1193.          because renaming an existing file on a diskette will not impact
  1194.          either of the two captured totals. These two totals, you will recall,
  1195.          deal with the total number of files on the diskette, & the sum total
  1196.          of file dates + times + sizes covering that diskette.
  1197.  
  1198.      2.  When you are displayed the volume heading information for a pre-
  1199.          viously cataloged diskette, you are given the following column
  1200.          headings:
  1201.  
  1202. VOL# --PATH-- NOTE/EXT-PATH LAST UPDATE #FIL KBLF L F O VER BUY NV TSQ NEXT LAST
  1203.  
  1204.  
  1205.      The unobvious column headings above mean the following:
  1206.  
  1207.      KBLF         The number of kilobytes available for additional file use.
  1208.  
  1209.      L            Location where the prior cataloging processing took place.
  1210.  
  1211.      F            The letter of the hard disk from which these files came
  1212.                   from.
  1213.  
  1214.      O            The operating system type under which the cataloged diskette
  1215.                   was formatted.
  1216.  
  1217.      VER          The operating system version number under which the
  1218.                   cataloged diskette was formatted.
  1219.  
  1220.      NV           The newest version file of all files on this diskette. This
  1221.                   information is only available if the add-on software module,
  1222.                   which does the aging analysis, is owned & ran against your
  1223.                   database. This add-on software module is not yet available,
  1224.                   as of the release time of this document. It will be
  1225.                   available in a matter of months.
  1226.  
  1227.                   When this field is operational, if it contained the number
  1228.                   "2" or higher, it would mean that nothing on this file is
  1229.                   most recent compared to same named files on other diskettes.
  1230.                   You could conceivably reuse this diskette if you aren't
  1231.                   interested in prior versions of your files.
  1232.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 28
  1233.  
  1234.  
  1235.  
  1236.      TSQ          This represents two columns of information without a
  1237.                   separating blank space between them:
  1238.                   T     Sequence type (eg, B=BACKUP, P=SOFTWARE PACKAGE)
  1239.                   SQ    Sequence number (ie, 01-99).
  1240.  
  1241.      3.  You can remove the diskette from the disk drive which is being
  1242.          cataloged when you see on your screen either of the following two
  1243.          messages. If you have another diskette to process, you can insert it
  1244.          at this time.
  1245.  
  1246.          a) "Will display each input directory filename as it is processed:"
  1247.          b) "Input directory has no files on it--processing as a scratch
  1248.             volume."
  1249.  
  1250.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 29
  1251.  
  1252.  
  1253.                                         =ML
  1254.  
  1255.                        INQUIRING AGAINST THE DBS-KAT CATALOG
  1256.                        -------------------------------------
  1257.  
  1258.                                  INVOKING DBS-KAT
  1259.  
  1260.      Before you actually update & inquire against your database, you should
  1261.      read the last remaining section, which comes in the next section
  1262.      "MAINTAINING & RECOVERING YOUR DATABASE."
  1263.  
  1264.      The main purpose for having DBS-KAT is to ask it which diskette(s) has
  1265.      such & such file on it?  This is done by the catalog inquiry program
  1266.      function, which can be invoked in a variety of ways. You can enter the
  1267.      commands in upper or lower case, it makes no difference. These commands
  1268.      are entered at the DOS prompt level.
  1269.  
  1270.      INVOKE CMD   COMMENT-------------------------------------------------
  1271.  
  1272.      KATLOOK      This is the quickest way to look at your database. If you
  1273.                   chose the alternate route of KAT -D, it would invoke KATLOOK
  1274.                   anyway. So you save having to have the computer first load
  1275.                   KAT.EXE followed by then loading KATLOOK.EXE if you just
  1276.                   type KATLOOK & press ENTER.
  1277.  
  1278.      KAT -D       Same as KATLOOK, except computer takes a couple of seconds
  1279.                   longer to function.
  1280.  
  1281.      KATLOOK -P   Same as KATLOOK, except you request that DBS-KAT does not
  1282.                   show in the PATH & EXT PATH/NOTE columns the subdirectory
  1283.                   information if the file entry sat in a subdirectory on the
  1284.                   diskette. The only thing that would be shown in these two
  1285.                   columns would be information from the diskette volume header
  1286.                   record.
  1287.  
  1288.                   Since most users will not be utilizing subdirectories on
  1289.                   their diskettes, KATLOOK gives the same results as entering
  1290.                   KATLOOK -P.
  1291.  
  1292.                   KATLOOK -P was inserted into the product during the
  1293.                   debugging phase of catching the individual file entry
  1294.                   elongated directory name at display time. You'll recall from
  1295.                   the Overview subsection in the Introduction that the
  1296.                   database only carries a numeric code for the subdirectory
  1297.                   diskette location it belongs with in each database record.
  1298.                   However, this feature was left in the program, since some
  1299.                   users might want to take advantage of this option, & it
  1300.                   really causes no overhead to the program's performance to
  1301.                   leave it in.
  1302.  
  1303.      KAT -DP      See above discussion about KAT -D. Otherwise, this is the
  1304.                   same as entering KATLOOK -P.
  1305.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 30
  1306.  
  1307.  
  1308.  
  1309.      KATLOOK -L   Inquire against the database located in the current
  1310.                   directory.
  1311.  
  1312.      KAT -LD      See above discussion about KAT -D. Otherwise, this is the
  1313.                   same as entering KATLOOK -L.
  1314.  
  1315.  
  1316.                                THE INQUIRY PROCEDURE
  1317.  
  1318.      The inquiry program is menu driven & your choices for action are dis-
  1319.      played as follows:
  1320.  
  1321.      -------------------------------------------------------------------------
  1322.      CHOOSE TYPE OF DIRECTORY DISPLAY DESIRED:
  1323.      1. Process individual dir argument line.
  1324.      2. Process all cataloged files for a given volume number.
  1325.      3. Process all cataloged files for the entire database.
  1326.      4. Listing of cataloged diskette volumes.
  1327.      5. Listing of uncataloged diskette volumes.
  1328.      6. Exit program.
  1329.                                     6
  1330.      Enter option number:          > <
  1331.      -----------------------------------------------------------------------
  1332.  
  1333.      Most of the prompts & activity occurring in the inquiry procedure are
  1334.      self evident, based upon the user understanding the cataloging process &
  1335.      being able to read the inquiry procedure displays & prompts.
  1336.  
  1337.      This documentation will cover the portions of this procedure which may
  1338.      not be completely self-evident.
  1339.  
  1340.      1.  If your database was set up with a user password, you are asked for
  1341.          it in this program. You must provide the user password in order to
  1342.          inquire against the database. When you type in your password, you
  1343.          will not see what you type in nor will your cursor move. That is
  1344.          normal. This way, your friend behind you won't see your password.
  1345.  
  1346.      2.  When you are displayed the filename heading information, you are
  1347.          given the following column headings:
  1348.  
  1349. VOL# FILENAME.EXT FLDATE FLTM --SIZE- --PATH-- NOTE/EXT-PATH LTSQGT LAST-UPDATE
  1350.  
  1351.          With the exception of "FILENAME.EXT" & "LTSQGT", the above column
  1352.          headings also appear in the previous section in "THE CATALOGING PRO-
  1353.          CEDURE" subsection.
  1354.  
  1355.          Two exception to being the same as THE CATALOG PROCEDURE heading are
  1356.          the "--PATH-- NOTE/EXT-PATH" headers. These columns will show the
  1357.          actual diskette subdirectory (the first 22 characters) which the
  1358.          cataloged file sits in, if such is the case, rather than the volume
  1359.          heading Note/Ext-Path information. Again, if the diskette file does
  1360.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 31
  1361.  
  1362.  
  1363.          not reside on the diskette in a subdirectory, the shown information
  1364.          derives from the volume label record.
  1365.  
  1366.          LTSQGT represents five columns of information without a separating
  1367.          blank space between them.
  1368.  
  1369.          L   Location where the prior cataloging processing for this disk took
  1370.              place.
  1371.  
  1372.          T   Sequence type (eg, B=BACKUP, P=SOFTWARE PACKAGE).
  1373.  
  1374.          SQ  Sequence number (ie, 01-99).
  1375.  
  1376.          G   How many generations old is this filename in relationship to the
  1377.              most current file with this same FILENAME.EXT, which is gener-
  1378.              ation 0. Generation 9 would be for the 9th plus higher genera-
  1379.              tions. This information & that of the following adjacent field is
  1380.              not updated by the base package. An add-on software module
  1381.              program, which does the aging analysis, will update this field.
  1382.  
  1383.          T   Is the generation number for this FILENAME.EXT tied ("Y" or
  1384.              blank).
  1385.  
  1386.      3.  If you choose the directory display option number 1 (Process indi-
  1387.          vidual dir argument line) & ask to "Suppress console output", you can
  1388.          ask that the displayed output go either to the printer or to a file.
  1389.          If you choose a file output, you are given the opportunity to use the
  1390.          filename, KATDIR.OUT, or you can create your own valid filename.
  1391.          File-directed output will not contain the column headings. A DOS
  1392.          batch command file, KATSORT, is provided which will sort KATDIR.OUT
  1393.          in reverse chronological order. You must exit this program & execute
  1394.          the procedure, KATSORT, at the DOS prompt level.
  1395.  
  1396.      4.  If you choose the directory display option number 1 (Process indi-
  1397.          vidual dir argument line), you might be a little unfamiliar with your
  1398.          search options. The program at this point displays the following
  1399.          instructions:
  1400.  
  1401.             "For your search argument, you'll be asked for a string value &
  1402.             how to use this string in the search (exact compare, anchored sub-
  1403.             string compare, or un-anchored substring compare - E, A, U). You
  1404.             are not allowed to use the following characters: '*', '?', '+'.
  1405.             Just pressing ENTER for a string value indicates no restriction."
  1406.  
  1407.          The DOS DIR command provides an anchored substring search capability.
  1408.          If you typed: DIR AUTO* & pressed ENTER, you would be doing an
  1409.          anchored substring compare. Although DOS does not provide an un-
  1410.          anchored substring search, if it did, typying: DIR *TO* & pressing
  1411.          ENTER, would provide you with a list of filenames where floating any-
  1412.          where in the filename portion are the two neighboring characters
  1413.          "TO". This is an example of an un-anchored substring search.
  1414.  
  1415.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 32
  1416.  
  1417.  
  1418.          Although, DBS-KAT provides an un-anchored substring compare, this
  1419.          type of search on the filename portion will cause every filename
  1420.          entry in your database to be scanned, which can take awhile depending
  1421.          on the size of your database.
  1422.  
  1423.          The TECHNICAL REFERENCE MANUAL overviews the structure of DBS-KAT's
  1424.          database design & provides an  elaborate example list representing a
  1425.          range of searchs ordered by a most efficient search argument to a
  1426.          least efficient search argument.
  1427.  
  1428.          However, don't be afraid to use the search strategy you need to
  1429.          accomplish the job you want done. With a 12,000 record database, best
  1430.          case searches are a few seconds long & worst case searches are
  1431.          a few minutes long.
  1432.  
  1433.      5.  If you choose to provide a path argument search & to have it used
  1434.          against cataloged filenames, it is used against the diskette volume
  1435.          label pathname, unless the file is residing in a subdirectory on the
  1436.          cataloged diskette.  In that case, you can search for the file by
  1437.          providing the name (or part of the name) of the subdirectory;
  1438.          however, instead of using a backslash character, use a foreslash
  1439.          character (/) to indicate the directory slash.  DBS-KAT converts the
  1440.          directory slash to a foreslash (/), when updating the database.
  1441.  
  1442.      6.  If you choose to only provide a path/note argument search (no
  1443.          filename/ext search argument), you'll be asked if you want the search
  1444.          to be only against cataloged volume header records rather than
  1445.          against cataloged filenames. Choosing the volume header search will
  1446.          make your scan a whole lot faster.
  1447.  
  1448.      7.  Diskettes that are empty of files are marked "SCRATCH".  By providing
  1449.          a path/note argument with the value "SCRATCH" or "scratch" & to have
  1450.          it used only against cataloged volume header records, you will be
  1451.          provided with a list of scratch diskettes.
  1452.  
  1453.      8.  Option 3 now supports unloading the entire database to a flat file or
  1454.          processing the entire database within a beginning & ending date
  1455.          range.  Try option 3 & play around with the combinations.
  1456.  
  1457.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 33
  1458.  
  1459.  
  1460.                                         =MP
  1461.  
  1462.                            TAKING CARE OF YOUR DATABASE
  1463.                            -----------------------------
  1464.  
  1465.                                      OVERVIEW
  1466.  
  1467.      This section covers the following activities:
  1468.  
  1469.         1. Conservative Updating
  1470.         2. Backup
  1471.         3. The Log File
  1472.         4. Integrity Analysis
  1473.  
  1474.      A related section on Recovery is included in the TECHNICAL REFERENCE
  1475.      MANUAL, because not every user will ever need it. However, every user
  1476.      should be prepared for it by following the recommendations below.
  1477.  
  1478.  
  1479.                                CONSERVATIVE UPDATING
  1480.  
  1481.      Databases are delicate creatures. Most programs which work with data-
  1482.      bases, assume that all the proper connections are made between the dif-
  1483.      ferent records in a database. Such programs, when they come across the
  1484.      first data record with its associated pointer addresses to another record
  1485.      failing to properly point, will abort. Thus often a very large database
  1486.      is at the mercy of one bad pointer. Pointers, like other portions of a
  1487.      disk file, can be disturbed by a variety of external hardware & software
  1488.      factors, many of which lie totally outside of the software which is spe-
  1489.      cifically written for the database.
  1490.  
  1491.      Conservative practices are to frequently backup up the database & to do a
  1492.      periodic integrity analysis of the database. If you're doing a hundred or
  1493.      more diskettes in the beginning in a day, then maybe every 33-50 dis-
  1494.      kettes, back up your database. If you're updating a few diskettes per
  1495.      day, then one or two days a week you should back up the database.
  1496.  
  1497.  
  1498.                                       BACKUP
  1499.  
  1500.      You are advised to back up your database while inside the KAT -U (or any
  1501.      variation of the -U option) program. Your database backup will be made
  1502.      according to the instructions you gave DBS-KAT in updating your system
  1503.      control record. Most persons will want to take advantage of the default
  1504.      backup command which one is prompted with during the system control
  1505.      record add process.
  1506.  
  1507.      During the KAT -U program session, you can choose to backup your database
  1508.      at the beginning of each processing loop, or after you have processed the
  1509.      number of diskettes equal to the reminder interval count you provide DBS-
  1510.      KAT in your system control record update process.
  1511.  
  1512.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 34
  1513.  
  1514.  
  1515.      The existence & usefulness of your log file is discussed shortly, however
  1516.      it relevant to note now that DBS-KAT records in this log file when you
  1517.      made a backup of your database. It also makes a record entry, including
  1518.      the volume number, of each updated diskette.
  1519.  
  1520.      For the above reason, it is a good idea to update DBS-KAT against the
  1521.      diskettes you just backed up your database onto, right after doing the
  1522.      backup & before processing any other diskettes. This way, when you inter-
  1523.      rogate your log file, those diskettes which immediately follow a backup
  1524.      record entry are the diskettes which contain your database. This is
  1525.      useful, when looking for your couple-to-several generation old set of
  1526.      database backup diskettes to reuse. You can also use DBS-KAT's inquiry
  1527.      function to find out the same information, but some people may prefer one
  1528.      method over the other method. The log file's main purpose is for recovery
  1529.      & not for locating backup diskette.
  1530.  
  1531.      Despite DBS-KAT's ability to inform you of which diskette follows in a
  1532.      sequence, you'll still find it more convenient, if your database backup
  1533.      span across neighboring numbered diskettes. Thus when you initially
  1534.      number your diskettes, you might want to set aside 3-4 neighboring
  1535.      sequence for backing up your database. It currently takes about 2.5 dis-
  1536.      kettes to backup a database containing 13,400 plus directory entries,
  1537.      which covers about 600 diskettes. You should felt-tip label these dis-
  1538.      kettes, beside the normal 4 digit number, with information such as:
  1539.                                      0333
  1540.             KATDB.*  1 of 4
  1541.             See 0334-0336
  1542.             Verified: 850301/850501/850701
  1543.             850901
  1544.  
  1545.      The above label shows the following information:
  1546.  
  1547.         1. The volume ID number for this diskette.
  1548.         2. Information that the diskette contains a backup of the database.
  1549.         3. Information that this diskette is number 1 of a set of 4 backup
  1550.            diskettes.
  1551.         4. The numerous different dates for which this database was a backup
  1552.            of a database right after it had been okayed via a database
  1553.            integrity analysis run. In this instance, the verify dates spill
  1554.            over onto line four of the label.
  1555.  
  1556.      In conjunction with using the DOS BACKUP command, one should periodically
  1557.      perform a CHKDSK /F. In the April 23, 1985, issue of PC WEEK, a letter to
  1558.      the editor by a VP of SyntheSys Consulting Inc., Syracuse, NY, entitled
  1559.      "Fixing BACKUP Bugs," refers to "problems with the [BACKUP] program if
  1560.      CHKDSK detects any errors on the disk you are trying to back up. The user
  1561.      should be sure to use CHKDSK to correct any problems with the hard disk
  1562.      before using BACKUP (i.e., use CHKDSK with the /F option)."
  1563.  
  1564.                                    THE LOG FILE
  1565.  
  1566.      Each diskette that you process by DBS-KAT causes a record to be written
  1567.      to a plain ASCII-type file (useable by most word processors), called
  1568.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 35
  1569.  
  1570.  
  1571.      KATDB.LOG. When you backup the database is recorded here too. The
  1572.      information written about the diskette processed is in the following
  1573.      format (example data displayed beneath the format). The format heading
  1574.      here does not appear in the file, KATDB.LOG, nor by the KATLOG printout.
  1575.  
  1576.        LN  LOC VOL# YYMMDD HHMM TOT-REC-COUNT
  1577.         1    H 0075 850503 1354 13035
  1578.         2    H B/U  850503 1355
  1579.         3    H 0174 850503 1400 13039
  1580.         4    H 0175 850503 1400 13043
  1581.         5    H 0176 850503 1401 13047
  1582.         6    H 0199 850503 1401 13099
  1583.  
  1584.      The main reason for this log file is in the unlikely event that something
  1585.      happens either to your hard disk or to your database & you need to do a
  1586.      recovery using an earlier backed up database. The exact procedures you'll
  1587.      follow are given in the TECHNICAL REFERENCE MANUAL.
  1588.  
  1589.      Another usage for the log file, if you want to use it in such a manner
  1590.      (as shown in the above example), was earlier discussed in the subsection,
  1591.      BACKUP. The above example reflects the fact that after processing volume
  1592.      0075, the user backed his database over three diskettes, 0174-0176, after
  1593.      which he updated DBS-KAT with the directory information of diskettes
  1594.      0174-0199.
  1595.  
  1596.      A DOS batch procedure file, called KATLOG.BAT, is provided to aid you in
  1597.      inquiring against your log file. KATLOG can be invoked in a variety of
  1598.      ways. You can enter the commands in upper or lower case, it makes no dif-
  1599.      ference. These commands are entered at the DOS prompt level.
  1600.  
  1601.      INVOKE CMD      COMMENT--------------------------------------------------
  1602.  
  1603.      KATLOG          Typing just this causes the entire log file to be con-
  1604.                      tinuously printed, using the KPRINT program. KPRINT is
  1605.                      explained in Appendix A. Lines numbers are printed for
  1606.                      this option.
  1607.  
  1608.      KATLOG 35       Any number is allowed. Typing this causes the last 35
  1609.                      lines of your log file to be displayed to your screen.
  1610.                      KATLOG uses your DOS program, MORE.COM, so be sure to
  1611.                      have it available (via your PATH) to be executed in the
  1612.                      directory from which you execute KATLOG. With the MORE
  1613.                      program, if you ask for more than a screen worth, you'll
  1614.                      be shown a screen worth at a time. Pressing any key
  1615.                      (except the CTRL-BREAK combination) will cause the next
  1616.                      page to be displayed to the screen. Holding down the CTRL
  1617.                      key while pressing the BREAK key will abort KATLOG --
  1618.                      you'll be asked if you want to terminate the batch pro-
  1619.                      cedure then. If you answer "Y", the batch procedure will
  1620.                      immediately abort.
  1621.  
  1622.      KATLOG 35 PRN   Same as KATLOG 35, except output is printed, & the DOS
  1623.                      program, MORE.COM is not used.
  1624.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 36
  1625.  
  1626.  
  1627.  
  1628.  
  1629.                                 INTEGRITY ANALYSIS
  1630.  
  1631.      Every once in awhile (perhaps once a month), an integrity analysis should
  1632.      be done. It really takes no work on your part, & doing it while you are
  1633.      out to eat is the easiest way to schedule it into your day. More is said
  1634.      about doing an integrity analysis in a subsection below.
  1635.  
  1636.      There is nothing magic about the database integrity check program. It is
  1637.      an option in the KATLOOK (or KAT -D option) program. First, get inside to
  1638.      KATLOOK's menu choice. Refer to the section, INQUIRING AGAINST THE DBS-
  1639.      KAT CATALOG, if you forget how to invoke KATLOOK. To the following
  1640.      prompts, make the following responses:
  1641.  
  1642.      PROMPT------------------------   RESPONSE   COMMENT----------------------
  1643.  
  1644.      Enter option number:             3          "Process entire database"
  1645.                                                  option
  1646.  
  1647.      Want date range?                 ENTER      Default is "N", the correct
  1648.                                                  choice
  1649.  
  1650.      Suppress console output?         ENTER      Default is "N", the correct
  1651.                                                  choice
  1652.  
  1653.      Printout desired?                ENTER      Default is "N", the correct
  1654.                                                  choice
  1655.  
  1656.      Pause for each screen?           ENTER      Default is "N", the correct
  1657.                                                  choice
  1658.  
  1659.      KATLOOK will thereupon start from the beginning of your database &
  1660.      display every entry in your database. Every single record in every
  1661.      portion of your database will be retrieved. This can take an hour & a
  1662.      half if using a COMPAQ PLUS with 12,500 directory entries & 580 diskettes
  1663.      cataloged. If you have an IBM AT, your response time will be better.
  1664.  
  1665.      A good time to do this, as earlier said, is during eating time. When you
  1666.      come back to your machine then, you'll immediately know if any problem
  1667.      was encountered. If the last two lines displayed show the last entry in
  1668.      your database followed by the successful database close message, then you
  1669.      have a clean database.
  1670.  
  1671.      At this point, you are advised to backup up your database & label it as a
  1672.      "VERIFIED" backup. Do not recycle these backup diskettes until you have
  1673.      done at least another verified backup in the future using another set of
  1674.      diskettes. Once you have done this backup, you no longer need the current
  1675.      hard disk resident KATDB.LOG file. Type: DEL KATDB.LOG & press ENTER.
  1676.      Don't worry, immediately upon doing your next DBS-KAT process, KATDB.LOG
  1677.      will be recreated & start growing again.
  1678.  
  1679.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 37
  1680.  
  1681.  
  1682.                                         =ME
  1683.  
  1684.                                TROUBLE SHOOTING TIPS
  1685.  
  1686.      If the information in this section doesn't solve your problem, refer to
  1687.      the accompanying document, entitled "Advanced Database Integrity Analysis
  1688.      Discussion."  If that documentation doesn't solve your problem, consider
  1689.      reinstalling DBS-KAT by using the DBS-KAT manual for DOS-inexperienced
  1690.      users.  Failing that, if you're a registered DBS-KAT user, use the
  1691.      DBCHECK program to verify your database.  If all else fails, fill out &
  1692.      mail Applied Foresight the DBS-KAT problem form.  Print out this form
  1693.      typing: KAT -P & pressing ENTER.
  1694.  
  1695.      If you are ever aborted from DBS-KAT during the cataloging program, or if
  1696.      the cataloging program processes less than the full number of filenames
  1697.      on a diskette, check the free space on the device holding the work files,
  1698.      KATWORK1.DIR & KATWORK2.DIR. Also, type out these work files & see if the
  1699.      operating system issued any error messages.
  1700.  
  1701.      The message "Exec Failure," or "db_VISTA database error -905- error
  1702.      opening file", may mean that your "FILES=20" statement is either missing
  1703.      or has a lower number in your CONFIG.SYS file.  Don't forget to restart
  1704.      your computer after changing your CONFIG.SYS file.
  1705.  
  1706.      The message "db_VISTA database error -4 - invalid database" can appear if
  1707.      the program is not able to find the database. DBS-KAT attempts to open
  1708.      the database in the current directory. Failing that, it attempts to open
  1709.      the database in the \DBSKAT directory for the current drive.  Failing
  1710.      that, it attempts to open the database in the root (\) directory for the
  1711.      current drive.  If the database can't be found still, it will display the
  1712.      preceeding error message.  If the database exists in one of these three
  1713.      directories, the message may still appear if the program you are running
  1714.      is DBCHECK KATDB. (From the DBS-KAT utility disk -- see order form for
  1715.      information on how to obtain.) The DBCHECK KATDB command expects that the
  1716.      DBS-KAT database exists only in the current directory & additionally,
  1717.      that KATDB.H exists in that directory too. (This file comes with the
  1718.      DBCHECK program.)
  1719.  
  1720.      With the message "Bad command or file name" right after the
  1721.      "Do: B,D,E,F,H,L,P,S,T,V,W?" prompt, or the message "error in opening to
  1722.      read A:KATWORK2.DIR" in "KAT -U", verify that the DOS SORT program is in
  1723.      your path.  If it isn't, then insert your original DOS diskette in drive
  1724.      A: & type:    COPY  A:SORT.*  \    & press the ENTER key.
  1725.  
  1726.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 38
  1727.  
  1728.  
  1729.                       RUNTIME ERRORS IN PAST DBS-KAT VERSIONS
  1730.  
  1731.      Version 2.21 of DBS-KAT fixed a rare update bug that aborted one out of
  1732.      the update process.  The abort message would appear after the catalog
  1733.      processing message, "Will display each input directory filename as it is
  1734.      processed."  The abort message would read: "paths.pathkey for below is <a
  1735.      number> ... SUBR: add_path, DB_CALL: d_fillnew PATHS &paths..."  If this
  1736.      problem still occurs, it might be occurring either because of a
  1737.      "hangover" effect from Version 2.20, or it might be occurring because one
  1738.      has prematurely aborted (with CTRL-BREAK) out of DBS-KAT during an
  1739.      update.  The fix is to install Version 2.23 (or greater) & try to
  1740.      reprocess the diskette as normal.  If that doesn't work, then at the DOS
  1741.      prompt:
  1742.  
  1743.          type:  CD \DBSKAT           & press ENTER
  1744.  
  1745.          type:  KATLOOK -MF          & press ENTER
  1746.  
  1747.                continue to press ENTER until you see the below:
  1748.  
  1749.                "You have ran KATLOOK with the DBFIX option on.
  1750.                Only answer 'Y' to next question if Applied
  1751.                Foresight Inc. has advised you to."
  1752.                                            N
  1753.                Add 1 to High path #?      > <
  1754.  
  1755.          type:  Y                    & press ENTER
  1756.  
  1757.                continue to press ENTER until you have exited the program.
  1758.                Then reprocess your diskette again.  If the message reappears,
  1759.                repeat the preceeding steps until you can process the diskette
  1760.                without seeing the error message again.  At worse, you should
  1761.                only have to repeat the steps 1-4 times.
  1762.  
  1763.      The term "High Path" refers to the method DBS-KAT uses to carry sub-
  1764.      directory names attached to a cataloged filename.  The subdirectory name
  1765.      is not repeated for each cataloged entry.  That would be a waste of disk
  1766.      space.  Instead a number is carried that points to a standalone record
  1767.      that holds the subdirectory name just once.  When one adds a new sub-
  1768.      directory to the database, the system control record field, called "high
  1769.      path", is used to determine what number to assign to it.  Because of a
  1770.      bug in a past DBS-KAT version, and/or because of someone earlier aborting
  1771.      out of DBS-KAT prematurely, this abort situation could occur.
  1772.  
  1773.      Version 2.23 of DBS-KAT fixed a rare update bug that occurred when
  1774.      updating a diskette in which old files were changed to new diskette sub-
  1775.      directories.  The bug would display "db_VISTA database error -21 - field
  1776.      is sort field of connected record; ... SUBR: do_mrpass, DB_CALL:
  1777.      d_recwrite &ver..."  There was nothing wrong with the database & the only
  1778.      thing needed was this software fix.
  1779.  
  1780.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 39
  1781.  
  1782.  
  1783.                                     =MA =OR =PF
  1784.  
  1785.                                  ONLINE ASSISTANCE
  1786.  
  1787.      Typing:   KAT -O    & pressing the ENTER key will print out an order
  1788.      form, along with an explanation of registration benefits.
  1789.  
  1790.      If you want to view the order form online & you are running ML now, you
  1791.      can exit to DOS by pressing ESC & type: ML KATORDER.FRM & press ENTER.
  1792.      To return to this manual, you would then exit to DOS again & type: ML
  1793.      KATBOOK  & press ENTER.
  1794.  
  1795.      Typing:   KAT -P    & pressing the ENTER key will print out a problem
  1796.      form which can be used for submitting problems &/or enhancement requests.
  1797.  
  1798.      Typing:   KAT    & pressing the ENTER key will display the commands you
  1799.      can type in to run the various functions of DBS-KAT.
  1800.  
  1801.      Typing:   KAT > PRN   & pressing the ENTER key will print out the above
  1802.      display.
  1803.  
  1804.      Typing:   KPRINT   & pressing the ENTER key will display the features of
  1805.      the KPRINT programmer's print program.
  1806.  
  1807.      Typing:   KPRINT -?C>PRN   & pressing the ENTER key will print out the
  1808.      above display.
  1809.  
  1810.      Typing:   KPRINT -?K   & pressing the ENTER key will display how to
  1811.      interface your printer with the KPRINT program.
  1812.  
  1813.      Typing:   KPRINT -?KC>PRN   & pressing the ENTER key will print out the
  1814.      above display.
  1815.  
  1816.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 40
  1817.  
  1818.  
  1819.                                         =MK
  1820.  
  1821.                                     APPENDIX A:
  1822.                              ERRATA RE: KPRINT PROGRAM
  1823.  
  1824.      Note: for additional information about the KPRINT programmer's print
  1825.      program, refer to the preceeding section, "Online Assistance."
  1826.  
  1827.      Due to the Lattice C Compiler not supporting LPT2 & COM2, KPRINT will not
  1828.      work with either of these two ports. Carl Warren in MINI-MICRO SYSTEMS,
  1829.      April 1985 (page 187), provides a way for your computer to think of LPT2
  1830.      as LPT1 (and vice-versa) though. A BASIC program, he provides, based upon
  1831.      printer port information discussed in the IBM Technical Reference Manual,
  1832.      pages 5-25, is used to swap printer port locations for the duration of a
  1833.      power-on session. The program is reproduced below:
  1834.  
  1835.           05 REM DEFINE THE SEGMENT LOCATION
  1836.           10 DEF SEG = &H40
  1837.           15 REM FIND THE CONTENTS OF THE PORTS
  1838.           20 A = PEEK(&H8): B = PEEK(&H9)
  1839.           30 C = PEEK(&HA): D = PEEK(&HB)
  1840.           35 REM NOW SWAP THEM
  1841.           40 POKE &H8,C : POKE &H9,D
  1842.           50 POKE &HA,A : POKE &H8,B
  1843.           55 SYSTEM
  1844.  
  1845.      ~If this program was located in your root directory under the name,
  1846.      SWAPLPT.BAS, & you added the line, "BASICA \SWAPLPT", to your
  1847.      \AUTOEXEC.BAT file, this would be done for you automatically when you
  1848.      power on the computer. If you need to use COM2, use the DOS MODE command
  1849.      to associate COM2 with your LPT1 port. For both the LPT2 & COM2 solution
  1850.      discussed here, your KPRINT.CTL file would use a "T P 1" line.
  1851.  
  1852.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 41
  1853.  
  1854.  
  1855.                                     APPENDIX B:
  1856.  
  1857.                   KATSCAN HARD DISK ARCHIVE UTILITY DOCUMENTATION
  1858.  
  1859.      Include in the DBS-KAT manuals are a four page (80 column printout) on
  1860.      KATSCAN describes the KATSCAN program. Everything described in that doc-
  1861.      ument is on this diskette. This is NOT demo software!
  1862.  
  1863.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 42
  1864.  
  1865.  
  1866.                                         =MQ
  1867.  
  1868.                                     APPENDIX C:
  1869.  
  1870.                 KATASK BATCH MENU FACILITATOR UTILITY DOCUMENTATION
  1871.  
  1872.      KATASK is a simple, short program.  The purpose of this program is to
  1873.      facilitate displaying a menu of choices to a user from inside a DOS batch
  1874.      command file.  The method of doing this with KATASK is as follows:
  1875.  
  1876.         1.  Inside your DOS batch command file, use the DOS ECHO or REM
  1877.             command to display your menu to a user.  Assign a number starting
  1878.             from 1 to each displayed menu line item.
  1879.  
  1880.         2.  After the menu display lines, have a line that reads:
  1881.  
  1882.             KATASK n
  1883.  
  1884.             Substitute for "n", an actual number.  This number will be the
  1885.             default menu choice if the user just presses the ENTER key in
  1886.             response to your displayed menu.
  1887.  
  1888.         3.  KATASK reads in the input number & displays the following.  In the
  1889.             below example, 3 is the default choice.  KATASK requires the user
  1890.             to provide a number.  KATASK does not do a numeric value range
  1891.             check.  Your DOS batch file must use the IF ERRORLEVEL command to
  1892.             validate an allowable number range.
  1893.  
  1894.             Number of your menu choice? [default=3] =>
  1895.  
  1896.         4.  Whatever number is chosen (by default or by entry), KATASK sets
  1897.             the DOS ERRORLEVEL to that number & exits the program.
  1898.  
  1899.         5.  Follow the DOS documentation for the IF ERRORLEVEL command to
  1900.             process the KATASK output.  Look at the code in the DBS-KAT batch
  1901.             file, KATSORT.BAT for a process handling example.
  1902.  
  1903.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 43
  1904.  
  1905.  
  1906.                                         =MN
  1907.  
  1908.                                     APPENDIX D:
  1909.                               PROVIDED DBS-KAT FILES
  1910.  
  1911.      The distribution ShareWare diskette contains these files, which are com-
  1912.      pressed into the self-extracting archive program, DBSKAT.EXE:
  1913.  
  1914.      READ     ME    A short introductory note. To be read first.
  1915.      KATBOOK        The DBS-KAT manuals.
  1916.      ML       EXE   Mouse Lister ShareWare by Gil Yoder (with his permission).
  1917.      HELP     ML    Help file (& ShareWare order form for Mouse Lister).
  1918.      KAT      EXE   DBS-KAT program to update control record & catalog dis-
  1919.                     kette directory information into database.
  1920.      KATLOOK  EXE   Program to allow inquiry against database.
  1921.      KATSCAN  EXE   Program used by KAT.EXE to scan diskette directory.  Also
  1922.                     useful hard disk archive utility.
  1923.      KPRINT   EXE   Multi-feature print program. Made for programmers.
  1924.      KATLOG   BAT   This & KATSTRIP.BAT are used in maintaining & recovering
  1925.      KATASK   COM   Program to prompt user for menu choice number.
  1926.      KATSTRIP BAT   DBS-KAT.
  1927.      KATSORT  BAT   Batch file to sort cataloged filenames in reverse
  1928.                     chronological order. Use KATLOOK to output a file first.
  1929.      KATORDER FRM   Type: KAT -O to print this order form.
  1930.      KATBUG   FRM   Type: KAT -P to print this problem report form.
  1931.      KATDB    DBD   The database comprises this & the next 5 files.
  1932.      KATDB    DA1   " ".
  1933.      KATDB    DA2   " ".
  1934.      KATDB    DA3   " ".
  1935.      KATDB    KE1   " ".
  1936.      KATDB    KE2   " ".
  1937.      VOLSER   COM   This is a device volume labeler program in the public
  1938.                     domain written by T. A. Davis. Can be used by DBS-KAT.
  1939.  
  1940.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 44
  1941.  
  1942.  
  1943.                                     APPENDIX E:
  1944.                  MINIMUM COMPUTER FILES NEEDED TO OPERATE DBS-KAT
  1945.  
  1946.      An installed DBS-KAT drive volume needs the following files on a drive
  1947.      formatted with the "/S" option. Files marked with a "*" are your DOS
  1948.      operating system files.
  1949.  
  1950.      COMMAND  COM *
  1951.      AUTOEXEC BAT
  1952.      BACKUP   COM *
  1953.      CONFIG   SYS
  1954.      FORMAT   COM *
  1955.      KAT      EXE
  1956.      KATDB    DA1
  1957.      KATDB    DA2
  1958.      KATDB    DA3
  1959.      KATDB    DBD
  1960.      KATDB    KE1
  1961.      KATDB    KE2
  1962.      KATSCAN  EXE
  1963.      KATASK   EXE
  1964.      KATLOG   BAT
  1965.      KATLOOK  EXE
  1966.      KATSORT  BAT
  1967.      KPRINT   EXE
  1968.      MORE     COM *
  1969.      RESTORE  COM *
  1970.      SORT     EXE *
  1971.      LABEL    COM *
  1972.      VOLSER   COM    [can be used if one doesn't have LABEL.COM]
  1973.  
  1974.           DBS-KAT USER MANUAL      Copyright 1986-1990 R.H. Martin      P. 45
  1975.  
  1976.  
  1977.                                         =M3
  1978.  
  1979.                                     APPENDIX F:
  1980.                          WHY DOS 2.X USERS SHOULD UPDATE
  1981.                                TO DOS 3.2 OR DOS 3.3
  1982.  
  1983.      With DBS-KAT Version 2.10, users need to upgrade to DOS 3.X. DBS-KAT was
  1984.      developed under MS-DOS 3.10 & tested under it & PC-DOS 3.3. The new
  1985.      internal DOS functions available under DOS 3.X, which can be read in a
  1986.      DOS 3.X Technical Reference Manual, enabled DBS-KAT to jointly enjoy a
  1987.      performance upgrade & to support foreign users who represent a large
  1988.      portion of the registered users.
  1989.  
  1990.  
  1991.                                         =NC
  1992.  
  1993.                                     DBS-KAT (R)
  1994.  
  1995.                             The Easy, Practical, Super
  1996.                             Capacity Diskette Cataloger
  1997.                            And Hard Disk Archive Utility
  1998.  
  1999.  
  2000.                                  INSTALLATION FOR
  2001.                                 NEW COMPUTER USERS
  2002.  
  2003.  
  2004.                                         by
  2005.                                     R.H. Martin
  2006.  
  2007.  
  2008.  
  2009.                               Applied Foresight Inc.
  2010.                                   P.O. Box  20607
  2011.                              Bloomington, Minn. 55420
  2012.  
  2013.  
  2014.                                   April 24, 1990
  2015.  
  2016.  
  2017.  
  2018.  
  2019.                         Copyright 1986, 1987 by R.H. Martin
  2020.                                 All Rights Reserved
  2021.  
  2022.  
  2023.  
  2024.                           A DB-SHAREWARE Software Product
  2025.  
  2026.  
  2027.  
  2028.  
  2029.  
  2030.  
  2031.                     A limited license is hereby granted to copy
  2032.                   and distribute wholly unmodified copies of the
  2033.                DBS-KAT Software Diskette which contains this manual
  2034.  
  2035.                    (Read the manual, "THE DB-SHAREWARE PROGRAM"
  2036.                    for full details about this limited license)
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.  
  2044.  
  2045.  
  2046.           NOVICE INSTALL MANUAL      Copyright 1986 R.H. Martin         P. 2
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.                                  ABOUT THIS MANUAL
  2053.                                  -----------------
  2054.  
  2055.      A section is designated by a centered & underlined heading. Centered but
  2056.      NOT underlined headings are referred to as a subsection.
  2057.  
  2058.      Absolutely, do not use DBS-KAT prior to thoroughly following the
  2059.      installation instructions, including restarting your computer after fol-
  2060.      lowing the installation instructions.
  2061.  
  2062.  
  2063.  
  2064.                                         =NI
  2065.  
  2066.                                    INSTALLATION
  2067.                                    ------------
  2068.  
  2069.  
  2070.                                      OVERVIEW
  2071.  
  2072.      Installation requires that you configure your operating system
  2073.      environment to satisfactorily accomodate database management processing &
  2074.      that you install the DBS-KAT software on your hard disk.
  2075.  
  2076.      If you are already familiar with PC-DOS or MS-DOS, please follow the two
  2077.      page install instructions in the DBS-KAT general manual. These instruc-
  2078.      tions are for those persons unfamiliar with PC-DOS & MS-DOS.
  2079.  
  2080.      This manual only substitutes for the two page install instructions in the
  2081.      general DBS-KAT manual. Prior to using this manual, you should printout
  2082.      the general manual first & read its section on "Hardware Requirements."
  2083.      After you follow the install instructions given for novices below, read
  2084.      the general manual sections which follow its condensed install instruc-
  2085.      tions.
  2086.  
  2087.      Appendix E of the User Manual (find "MN") lists the files which the
  2088.      install process has you put on your drive.  If you want to delete the
  2089.      DBS-KAT install files from your hard disk, position your cursor in the
  2090.      same directory on your hard disk where you installed DBS-KAT & type:
  2091.          DEL  DBSKAT.EXE   & press ENTER.
  2092.          DEL  READ.ME      & press ENTER.
  2093.  
  2094.  
  2095.           NOVICE INSTALL MANUAL      Copyright 1986 R.H. Martin         P. 3
  2096.  
  2097.  
  2098.                           INSTALLATION INSTRUCTIONS FOR
  2099.                              THE DOS 3.0+ NOVICE USER
  2100.  
  2101.      Installation requires the following specific acts. It is assumed that
  2102.      your floppy disk drive used is drive A & that your fixed hard disk drive
  2103.      is drive C. It is assumed that you have installed the DBSKAT.EXE program
  2104.      into a directory on your fixed disk, called \DBSKAT, and that you have
  2105.      executed this program to create the DBS-KAT files and documentation.
  2106.      Read each step through before you actually following the instructions
  2107.      given during that step.
  2108.  
  2109.         1.  You need to ensure that everytime you power on, that your system
  2110.             comes up with the right date & time, with its computer environment
  2111.             in tune to your root directory, & that it can handle the extra
  2112.             demands put on it by multi-file processing. In this step, we'll
  2113.             handle the CONFIG.SYS file, which addresses these extra demands.
  2114.  
  2115.             With your prompt positioned on the hard disk, type: CD \ & press
  2116.             the ENTER key. This moves you to the root directory, if you are
  2117.             not already there.
  2118.  
  2119.             You may or may not have a CONFIG.SYS file. Type: DIR CONFIG.SYS &
  2120.             press the ENTER key.
  2121.  
  2122.             A)If you get the message "File not found", type the following
  2123.                lines:
  2124.  
  2125.                Type: ECHO FILES=20 > CONFIG.SYS & press the ENTER key.
  2126.                Type: TYPE CONFIG.SYS & press the ENTER key. You should see the
  2127.                below:
  2128.                   FILES=20
  2129.  
  2130.                If you don't see the above, redo this step again.
  2131.  
  2132.                Go to step 2 now.
  2133.  
  2134.             B) If you got a display with the bottom line starting out as "1
  2135.                file(s)...", type: TYPE CONFIG.SYS & press the ENTER key. If
  2136.                you don't see a line that start out with "FILES=", type the
  2137.                following lines:
  2138.  
  2139.                Type: COPY CONFIG.SYS CONFIG.SAV & press the ENTER key.
  2140.                Type: ECHO FILES=20 >> CONFIG.SYS & press the ENTER key.
  2141.                Type: TYPE CONFIG.SYS & press the ENTER key. You should see
  2142.                      the below [you may see other lines than the below in your
  2143.                      CONFIG.SYS file]:
  2144.  
  2145.                      FILES=20
  2146.  
  2147.                If you don't see the new line, perform the following recovery
  2148.                steps:
  2149.  
  2150.           NOVICE INSTALL MANUAL      Copyright 1986 R.H. Martin         P. 4
  2151.  
  2152.  
  2153.                   Type: COPY CONFIG.SAV CONFIG.SYS & press the ENTER key. Now
  2154.                   redo the above ECHO command followed by the TYPE command.
  2155.                   You can erase your backed up CONFIG.SYS file, type: DEL
  2156.                   CONFIG.SAV & press the ENTER key. Now go to step 2.
  2157.  
  2158.             C) If you did see a line that start out with "FILES=", you'll have
  2159.                to use an editor of some sort which can work with plain ASCII
  2160.                files. If you don't understand this last, sentence, then just
  2161.                follow the instructions here. We'll use the DOS freebie editor,
  2162.                EDLIN.COM. Make sure you have copied this program onto your
  2163.                hard disk from your original DOS diskette. Study the sample
  2164.                editing session shown on the next page before being given
  2165.                specific instructions:
  2166.  
  2167.                ===============================================================
  2168.                ACTUAL COMPUTER INPUT/OUTPUT                         Ref Line #
  2169.                -----------------------------------------------      ----------
  2170.                >COPY CONFIG.SYS CONFIG.SAV                               A
  2171.                    1 File(s) copied
  2172.  
  2173.                >TYPE CONFIG.SYS                                          B
  2174.                BREAK=ON
  2175.                FILES=20
  2176.                DEVICE=ANSI.SYS
  2177.  
  2178.                >EDLIN CONFIG.SYS                                         C
  2179.                End of input file
  2180.                *L                                                        D
  2181.                          1:*BREAK=ON
  2182.                          2: FILES=10
  2183.                          3: DEVICE=ANSI.SYS
  2184.                          4:
  2185.                *2                                                        E
  2186.                          2:*FILES=10                                     F
  2187.                          2:*FILES=20                                     G
  2188.                *L                                                        H
  2189.                          1: BREAK=ON
  2190.                          2:*FILES=20
  2191.                          3: DEVICE=ANSI.SYS
  2192.                          4:
  2193.                *E                                                        I
  2194.  
  2195.                >TYPE CONFIG.SYS                                          J
  2196.                BREAK=ON
  2197.                DEVICE=ANSI.SYS
  2198.                FILES=20
  2199.  
  2200.                >DEL CONFIG.SAV                                           K
  2201.                ==============================================================
  2202.  
  2203.                Because your CONFIG.SYS file may have a different number of
  2204.                lines in it than the one shown, you'll have to modify it fol-
  2205.           NOVICE INSTALL MANUAL      Copyright 1986 R.H. Martin         P. 5
  2206.  
  2207.  
  2208.                lowing the principles documented here, rather than blindly fol-
  2209.                lowing instructions. To aid you, you'll be given an overview of
  2210.                what occurred above.
  2211.  
  2212.                Line A shows the user typing the entire line following the
  2213.                prompt symbol ">". This is done for backup, safety purposes.
  2214.                You should perform this line as shown.
  2215.  
  2216.                Line B shows the user looking at the CONFIG.SYS file prior to
  2217.                entering into an EDLIN editor session. You can do this also if
  2218.                you want to.
  2219.  
  2220.                Line C shows the user invoking the EDLIN editor program against
  2221.                the file CONFIG.SYS. You should perform this line as well as
  2222.                Line D as shown. Line D lists the file to the screen. The
  2223.                output is the same as that of Line B, except that line numbers
  2224.                appear now.
  2225.  
  2226.                Line E shows the user typing this line number, corresponding to
  2227.                the "FILES=" statement & pressing the ENTER key. Using the
  2228.                appropriate line number, you should do this as well. Line F &
  2229.                the "2:*" of line G are shown in return, & the user's cursor is
  2230.                positioned to the right of the "*".
  2231.  
  2232.                Line G shows the user typing "FILES=20" & pressing the ENTER
  2233.                key. Using the appropriate line number, you should do this as
  2234.                well. Line H shows the user relisting the edited file.
  2235.  
  2236.                Line I shows the user ending the EDLIN editor session, which
  2237.                saves his changes to the disk & exits him back to the DOS
  2238.                level. Line J shows the user retyping the CONFIG.SYS file back
  2239.                to the screen. This confirms that the file was edited cor-
  2240.                rectly. Line K shows the user deleting the unused backup file.
  2241.  
  2242.         2.  You still need to ensure that everytime you power on, that your
  2243.             system comes up with the right date & time, with its computer
  2244.             environment in tune to your root directory and at least the DBSKAT
  2245.             directory. Similarly to how we handled the CONFIG.SYS file, we'll
  2246.             now handle the AUTOEXEC.BAT file, which can be made to ensure all
  2247.             these things. First, you are recommended to read the section in
  2248.             your DOS manual about "PATH".
  2249.  
  2250.             Regardless of whether you have a system clock, which you'll have
  2251.             if you have an IBM AT, you'll be recommended to include in your
  2252.             AUTOEXEC.BAT file DATE & TIME statements. This is because your
  2253.             clock can get off for several reasons, & being reminded of the
  2254.             current date & time upon each power-up is good practice. For sure,
  2255.             your clock will be off when you change to/from daylight savings
  2256.             time or when your clock battery gets weak.
  2257.  
  2258.             In addition, although it is not required, since it is a nice
  2259.             enough feature to include, you'll be shown a way to modify your
  2260.           NOVICE INSTALL MANUAL      Copyright 1986 R.H. Martin         P. 6
  2261.  
  2262.  
  2263.             system prompt to always remind you of where you are at on the hard
  2264.             disk.  The PROMPT ($P) line will change your system prompt from a
  2265.             ">" to a "(C:\)" instead. If you happen to be in a created
  2266.             directory that you might have for some other purpose, such as \WP
  2267.             (for your word processor), you'll see your prompt like this:
  2268.             "(C:\WP)".
  2269.  
  2270.             You may or may not have a AUTOEXEC.BAT file. Type:
  2271.             DIR AUTOEXEC.BAT & press the ENTER key.
  2272.  
  2273.             A) If you get the message "File not found", type the following
  2274.                lines:
  2275.  
  2276.                Type: ECHO PATH=C:\;C:\DBSKAT > AUTOEXEC.BAT & press the ENTER
  2277.                      key.
  2278.                Type: ECHO DATE >> AUTOEXEC.BAT & press the ENTER key.
  2279.                Type: ECHO TIME >> AUTOEXEC.BAT & press the ENTER key.
  2280.                Type: ECHO PROMPT ($P) >> AUTOEXEC.BAT & press the ENTER key.
  2281.                Type: TYPE AUTOEXEC.BAT & press the ENTER key. You should see
  2282.                      the below:
  2283.  
  2284.                      PATH=C:\;C:\DBSKAT
  2285.                      DATE
  2286.                      TIME
  2287.                      PROMPT ($P)
  2288.  
  2289.                If you don't see the above, redo the four ECHO lines, & don't
  2290.                forget one greater-than sign on the first line & two greater-
  2291.                than signs on the following lines.
  2292.  
  2293.                Go to step 3 now.
  2294.  
  2295.             B) If you got a display with the bottom line starting out as "1
  2296.                file(s)...", type: TYPE AUTOEXEC.BAT & press the ENTER key. If
  2297.                you don't see any lines that start out with "PATH", "DATE",
  2298.                "TIME" & "PROMPT", type the following lines:
  2299.  
  2300.                Type: COPY AUTOEXEC.BAT AUTOEXEC.SAV & press the ENTER key.
  2301.                Type: ECHO PATH=C:\;C:\DBSKAT >> AUTOEXEC.BAT & press the ENTER
  2302.                      key.
  2303.                Type: ECHO DATE >> AUTOEXEC.BAT & press the ENTER key.
  2304.                Type: ECHO TIME >> AUTOEXEC.BAT & press the ENTER key.
  2305.                Type: ECHO PROMPT ($P) >> AUTOEXEC.BAT & press the ENTER key.
  2306.                Type: TYPE AUTOEXEC.BAT & press the ENTER key. You should see
  2307.                      the below [you may see other lines than the below in your
  2308.                      AUTOEXEC.BAT file]:
  2309.  
  2310.                      PATH=C:\;C:\DBSKAT
  2311.                      DATE
  2312.                      TIME
  2313.                      PROMPT ($P)
  2314.  
  2315.           NOVICE INSTALL MANUAL      Copyright 1986 R.H. Martin         P. 7
  2316.  
  2317.  
  2318.  
  2319.                If you don't see the new lines, perform the following recovery
  2320.                steps:
  2321.  
  2322.                   Type: COPY AUTOEXEC.SAV AUTOEXEC.BAT & press the ENTER key.
  2323.                   Now redo the above ECHO commands followed by the TYPE
  2324.                   command. Don't forget to use two greater-than signs for each
  2325.                   ECHO command line. You can erase your backed up AUTOEXEC.BAT
  2326.                   file, type: DEL AUTOEXEC.SAV & press the ENTER key. Now go
  2327.                   to step 3.
  2328.  
  2329.             C) If you did see lines that start out with "PATH", "DATE",
  2330.                "TIME", or "PROMPT", you may have to use an editor of some sort
  2331.                which can work with plain ASCII files. If you don't understand
  2332.                this last, sentence, then just follow the instructions here.
  2333.                We'll use the DOS freebie editor, EDLIN.COM. Make sure you have
  2334.                copied this program onto your hard disk from your original DOS
  2335.                diskette. Study the sample editing session shown on the next
  2336.                page before being given specific instructions:
  2337.  
  2338.           NOVICE INSTALL MANUAL      Copyright 1986 R.H. Martin         P. 8
  2339.  
  2340.  
  2341.                ==============================================================
  2342.                ACTUAL COMPUTER INPUT/OUTPUT                        Ref Line #
  2343.                ------------------------------------------------    ----------
  2344.                >COPY AUTOEXEC.BAT AUTOEXEC.SAV                              A
  2345.                    1 File(s) copied
  2346.  
  2347.                >TYPE AUTOEXEC.BAT                                           B
  2348.                PATH=C:\DOS
  2349.                VERIFY ON
  2350.                CHKDSK /F
  2351.  
  2352.                >EDLIN AUTOEXEC.BAT                                          C
  2353.                End of input file
  2354.                *L                                                           D
  2355.                          1:*VERIFY ON
  2356.                          2: PATH=C:\DOS
  2357.                          3: CHKDSK /F
  2358.                          4:
  2359.                *2 D                                                         E
  2360.                *L                                                           F
  2361.                          1: VERIFY ON
  2362.                          2:*CHKDSK /F
  2363.                          3:
  2364.                *I                                                           G
  2365.                          2:*PATH=C:\;C:\DOS;C:\DBSKAT                       H
  2366.                          3:*DATE                                            I
  2367.                          4:*TIME                                            J
  2368.                          5:*PROMPT ($P)                                     K
  2369.                          6:*^Z                                              L
  2370.                *E                                                           M
  2371.  
  2372.                >TYPE AUTOEXEC.BAT                                           N
  2373.                VERIFY ON
  2374.                PATH=C:\;C:\DOS;C:\DBSKAT
  2375.                DATE
  2376.                TIME
  2377.                PROMPT ($P)
  2378.                CHKDSK /F
  2379.  
  2380.                >DEL AUTOEXEC.SAV                                            O
  2381.                ==============================================================
  2382.  
  2383.                Because your AUTOEXEC.BAT file may have a different number of
  2384.                lines in it than the one shown, you'll have to modify it fol-
  2385.                lowing the principles documented here, rather than blindly fol-
  2386.                lowing instructions. To aid you, you'll be given an overview of
  2387.                what occurred above.
  2388.  
  2389.                You should first be forewarned that you might have an
  2390.                AUTOEXEC.BAT which "chains" to other ".BAT" files. If so, then
  2391.                it is very important that you have an experienced DOS user
  2392.                modify your AUTOEXEC.BAT correctly. Chances are that your
  2393.           NOVICE INSTALL MANUAL      Copyright 1986 R.H. Martin         P. 9
  2394.  
  2395.  
  2396.                AUTOEXEC.BAT file is not engaged in chaining operations, & the
  2397.                below instructions should suit you adequately.
  2398.  
  2399.                If you are curious whether a particular line is a command to
  2400.                chain to another .BAT file, you can verify your hunch in the
  2401.                following manner. Pretend a line in your AUTOEXEC.BAT file
  2402.                reads "MENU". To find out if this is a command to chain to a
  2403.                .BAT file or if it is invoking a program, type: CHKDSK/V | FIND
  2404.                "MENU." & press the ENTER key. If all you see in response
  2405.                (which might be 2-3 minutes) is something like this,
  2406.                "C:\UTIL\MENU.BAT", you can bet that AUTOEXEC.BAT will do a
  2407.                chain operation when this line is executed, meaning that no
  2408.                entries following this line will be executed if the chain line
  2409.                is executed. Again, if you suspect chaining to another .BAT
  2410.                file occurs in your AUTOEXEC.BAT file, you are recommended to
  2411.                seek the help of an experienced DOS user to modify your
  2412.                AUTOEXEC.BAT correctly.
  2413.  
  2414.                Line A shows the user typing the entire line following the
  2415.                prompt symbol ">". This is done for backup, safety purposes.
  2416.                You should perform this line as shown.
  2417.  
  2418.                Line B shows the user looking at the AUTOEXEC.BAT file prior to
  2419.                entering into an EDLIN editor session. You can do this also if
  2420.                you want to. Looking at this AUTOEXEC.BAT file, one can see
  2421.                that is lacks a "DATE", "TIME", & "PROMPT" statement.
  2422.  
  2423.                However, this AUTOEXEC.BAT does have some nice safety features
  2424.                in it. Notice that it does a CHKDSK /F for the user automati-
  2425.                cally upon power up. It also causes the DOS COPY VERIFY
  2426.                function to always work, regardless of using the "/V" on the
  2427.                DOS COPY command. You may also want to consider adding these
  2428.                two AUTOEXEC.BAT commands as well. You aren't required to by
  2429.                DBS-KAT though, just as you aren't required to use a special
  2430.                PROMPT. It's just that using these features can make your hard
  2431.                disk operations cleaner.
  2432.  
  2433.                The "PATH" line shown under Line B is inadequate for the only
  2434.                directory pointed to in it is the directory called "C:\DOS".
  2435.                For example, if the line read "PATH=C:\;C:\DOS;C:\DBSKAT",
  2436.                "PATH=\;\DOS;\DBSKAT", or  "PATH=\DOS;\;\DBSKAT", the "PATH"
  2437.                line would be correct. One does not need the "=" sign, in place
  2438.                of it could be a blank space. One can also have a semicolon ";"
  2439.                at the end of the line with no harm. What is wrong about the
  2440.                "PATH" statement shown by Line B's action is that the root
  2441.                directory "\" or "C:\" and the "\DBSKAT" or "C:\DBSKAT"
  2442.                directory is not in the PATH. The literal "C:\DOS" refers to
  2443.                the subdirectory "\DOS".
  2444.  
  2445.                If everything looks correct in your AUTOEXEC.BAT, you can
  2446.                proceed to Step 3 now.
  2447.  
  2448.           NOVICE INSTALL MANUAL      Copyright 1986 R.H. Martin         P. 10
  2449.  
  2450.  
  2451.                Line C shows the user invoking the EDLIN editor program against
  2452.                the file AUTOEXEC.BAT. You should perform this line as well as
  2453.                Line D as shown. Line D lists the file to the screen. The
  2454.                output is the same as that of Line B, except that line numbers
  2455.                appear now. You should note the first line number alongside the
  2456.                "PATH" statement. If you see a "PROMPT" statement, then you
  2457.                already know enough about it to have it already tailored to
  2458.                your needs & you might as well leave it as you already have it.
  2459.                If you see a "DATE" or "TIME" statement, then you don't need to
  2460.                delete it & then re-enter it. Leave these two statements where
  2461.                they lay.
  2462.  
  2463.                Line E shows the user deleting the old entry for the "PATH"
  2464.                statement. Using the appropriate line number, you should do
  2465.                this as well. Line F shows the user relisting the edited file.
  2466.                Note the re-arranging of the line numbers.
  2467.  
  2468.                Line G shows the user preparing to insert the lacking state-
  2469.                ments. If you already have a "PATH" line, but it doesn't
  2470.                include reference to the root directory, then retype a "PATH"
  2471.                line like the old, but with reference to the root directory in
  2472.                it, as shown in this example. Lines H through K show the actual
  2473.                insertion lines. Line L shows the user ending the insertion
  2474.                process by pressing the F6 function key followed by an ENTER
  2475.                key. You'll have to do this as well.
  2476.  
  2477.                Line M shows the user ending the EDLIN editor session, which
  2478.                saves his changes to the disk & exits him back to the DOS
  2479.                level. Line N shows the user retyping the AUTOEXEC.BAT file
  2480.                back to the screen. This confirms that the file was edited cor-
  2481.                rectly. Line O shows the user deleting the unused backup file.
  2482.  
  2483.         3.  You should restart your computer now. You will now benefit from
  2484.             the changes made above.
  2485.  
  2486.         4.  Make sure that you have the following DOS programs loaded onto
  2487.             your hard disk: FORMAT, SORT, BACKUP, RESTORE & MORE. These pro-
  2488.             grams are DOS programs which DBS-KAT expects to be able to run, if
  2489.             you choose the option which uses them. (Don't worry about the
  2490.             FORMAT command & your hard disk. DBS-KAT only allows you to FORMAT
  2491.             drive A or drive B.)  Chances are you have these programs already
  2492.             installed in a \DOS directory or your root directory. If you don't
  2493.             have these programs on your hard disk, insert your original DOS
  2494.             diskette in drive A: & type the following commands:
  2495.                COPY  A:FORMAT.*  C:\ /V   & press ENTER.
  2496.                COPY  A:BACKUP.*  C:\ /V   & press ENTER.
  2497.                COPY  A:RESTORE.* C:\ /V   & press ENTER.
  2498.                COPY  A:SORT.*    C:\ /V   & press ENTER.
  2499.                COPY  A:MORE.*    C:\ /V   & press ENTER.
  2500.  
  2501.         5.  Hopefully you have done this before this, but to be safe, we will
  2502.             verify that your equipment meets the recommended requirements
  2503.             listed under the "HARDWARE REQUIREMENTS" section.
  2504.           NOVICE INSTALL MANUAL      Copyright 1986 R.H. Martin         P. 11
  2505.  
  2506.  
  2507.  
  2508.             First, you should have an IBM or compatible type personal com-
  2509.             puter. This product was developed on a COMPAQ PLUS and Heathkit Z-
  2510.             241 AT Compatible, so it definitely runs on an IBM compatible type
  2511.             computer.
  2512.  
  2513.             Next, you need to have the correct version of either the PC-DOS or
  2514.             the MS-DOS operating system. Type: VER & press the ENTER key. The
  2515.             N.NN number which appears on the far right hand side of the dis-
  2516.             played line should be greater than or equal to 3.00. If it is, &
  2517.             you either see the phrase "PC-DOS" or "MS-DOS", then you have a
  2518.             supported operating system environment. The current version of
  2519.             DBS-KAT was developed under MS-DOS 3.10.
  2520.  
  2521.             Next, you need to know about your hard disk & available user
  2522.             memory. Type: CHKDSK C: & press the ENTER key. If you get the
  2523.             message "Bad command or file name", you should put your original
  2524.             DOS diskette in drive A & type: A:CHKDSK C: & press the ENTER key.
  2525.  
  2526.                If the program asks you for a "Y" or "N", go ahead & answer "N"
  2527.                for the time being. When you get the prompt back, you might
  2528.                want read up in your DOS manual about the CHKDSK program. Then
  2529.                you should consider rerunning the command in the following
  2530.                manner. Type: CHKDSK C:/F & press the ENTER key. When given the
  2531.                "Y" or "N" prompt, answer "Y" this time. Then you might want to
  2532.                type out the files, "C:\FILE0???.CHK". You should seek expert
  2533.                advice about what these file displays mean. Once satisfied, you
  2534.                could then delete these files "C:\FILE0???.CHK".
  2535.  
  2536.             The number that appears alongside the CHKDSK phrase "bytes total
  2537.             disk space" should be at least a 7 or higher digit number,
  2538.             indicating that you intend to run your software either on a high
  2539.             capacity 1.2MB floppy or, preferrably, on a hard disk (in which
  2540.             case, you'll have a 8 or higher digit number).
  2541.  
  2542.             The number that appears alongside the CHKDSK phrase "bytes
  2543.             available on disk" should indicate at least 500,000 (or 0.5 MB),
  2544.             for with the software & even a small DBS-KAT database (after a
  2545.             month's usage), you'll be using up at least this much disk space.
  2546.             Covering 500 diskettes & 10,050 filenames, will require about
  2547.             925,000 bytes (or 0.925 MB). This 0.925 MB figure includes the
  2548.             DBS-KAT software space requirements.
  2549.  
  2550.             Make sure you have adequate disk space before doing DBS-KAT
  2551.             install.
  2552.  
  2553.             The number that appears alongside the CHKDSK phrase "bytes free"
  2554.             indicates available user memory (RAM available). You are advised
  2555.             to have at least 262,144 bytes of RAM or 256K RAM free before
  2556.             running DBS-KAT. DBS-KAT may run slightly under that amount of RAM
  2557.             free space, but you do so at your own risk.
  2558.  
  2559.           NOVICE INSTALL MANUAL      Copyright 1986 R.H. Martin         P. 12
  2560.  
  2561.  
  2562.         6.  Go to paragraph number 6 (find "M6" -- press "Home" first) in the
  2563.             USER MANUAL under the subsection entitled "SHORT INSTALLATION
  2564.             INSTRUCTIONS FOR THE DOS 3.0+ EXPERIENCED USER", in the section on
  2565.             "INSTALLATION."
  2566.  
  2567.                                    OVERVIEW:                            =DO
  2568.         DBS-KAT (R) - THE COMPLETE FILE LIBRARIAN DB-SHAREWARE PACKAGE
  2569.  
  2570.             The Easy, Practical, Super Capacity Diskette Cataloger
  2571.                          And Hard Disk Archive Utility
  2572.                           by Applied Foresight, Inc.
  2573.                                 P.O. Box 20607
  2574.                            Bloomington, Minn.  55420
  2575.                      (C) Copyright 1986-1990 R.H. Martin.
  2576.                              All Rights Reserved.  
  2577.  
  2578.      DBS-KAT is a DB-SHAREWARE product which means the basic, full-featured, 
  2579.      system disk can be freely shared with other users. For more information 
  2580.      about DB-SHAREWARE, a manual introducing the program is on the system 
  2581.      disk for you to print out.  (Find "DS" after pressing "Home".)
  2582.  
  2583.      DBS-KAT is for 320 KB RAM computers which have at least PC-DOS or MS-
  2584.      DOS 3.00 or greater and have a hard disk.
  2585.  
  2586.  
  2587.                            DBS-KAT BASE SYSTEM FEATURES
  2588.  
  2589.      OVERALL FEATURES:
  2590.  
  2591.      * Accomodates 9,999 diskettes containing up to 16 million filenames in 
  2592.        one central database.
  2593.      * Accomodates cataloging removeable disk cartridges.
  2594.      * Filenames cataloged without any data entry required.
  2595.      * Designed to meet the cataloging needs of hard disk owners.
  2596.      * Enables hard disk owners to consider their diskettes an extension of
  2597.        their hard disk subdirectories.
  2598.      * Condensed online help screen.
  2599.      * Feature-rich programmer source code print program included (KPRINT).
  2600.      * Useful hard disk archive utility program included (KATSCAN).
  2601.      * Useful batch file utility program to facilitate menu-driven operations
  2602.        included (KATASK).
  2603.      * Nifty file viewing shareware program included (ML by Gil Yoder) which
  2604.        can be used with keyboard &/or mouse (users are requested to register
  2605.        direct with Gil Yoder).
  2606.      * Thorough documentation, including recovery documentation & a manual for 
  2607.        both DOS novices & advanced users, which can be read online or printed.
  2608.      * Version 2.10 & greater reads the volume label in such a way as to 
  2609.        support non-USA PC/MS-DOS versions. 
  2610.  
  2611.      CATALOG UPDATING FEATURES:
  2612.  
  2613.      * Add or change a 4 digit diskette volume label within program.
  2614.      * Embedded volume labels of any length/format can be retained.  User must
  2615.        assign a logical 4 digit diskette volume ID to associate w/diskette.
  2616.      * Optionally create unique header record for each cataloged diskette. 
  2617.      * Diskette header carries freespace and filesum number for each 
  2618.        diskette without any user entry involved.
  2619.      * Allows user-created default answers to diskette header fields, which
  2620.        can be changed or over-ridden.
  2621.      * Files located in diskette subdirectories are automatically cataloged.
  2622.      * Allows directory lists, deletes, or format of diskettes within program.
  2623.      * Allows a database backup while in the program.
  2624.      * Switch to cataloging another diskette drive or removeable disk 
  2625.        cartridge while in the program.
  2626.      * Empty diskettes are specially processed as scratch diskettes.
  2627.  
  2628.      * Optimized for speed, written in C using DB_VISTA database manager.
  2629.      * Recognizes a previously cataloged, unchanged diskette, informs the 
  2630.        user and bypasses recataloging.
  2631.      * Optional support for RAM disk utilization for program work files.
  2632.      * Uses file compression techniques.
  2633.      * Maintains a log file of 4 digit volume IDs processed,
  2634.        which can aid database recovery if the database is ever damaged.
  2635.  
  2636.      CATALOG INQUIRY FEATURES:
  2637.  
  2638.      * Password required to view contents of database, --database owner can
  2639.        change this password (i.e., 2 passwords: user's & owner's).
  2640.      * Lists all database filenames or diskette header records, or subsets of
  2641.        either.
  2642.      * Can list diskettes by volume ID order or by descending free space 
  2643.        order.
  2644.      * Can list diskettes whose header record meets the selection criteria 
  2645.        given by user.  
  2646.      * Provides list of scratch diskettes.
  2647.      * Easy method to list what diskettes hold backups of DBS-KAT database.
  2648.      * Diskette list shows the previous & following diskette volume for a 
  2649.        multi-diskette set.  
  2650.      * Identifies BACKUP or other type volume.  
  2651.      * Lists uncataloged diskette numbers available.
  2652.      * Selection can be by exact or partial match.
  2653.      * User's search phrase can be exact length or be a left justified phrase
  2654.        or floating phrase.  
  2655.      * Selection can include the filename, file extension, comment information,
  2656.        a beginning/ending filedate range, &/or directory location (if contained 
  2657.        in a directory on the diskette).
  2658.      * Retrieval can be limited to entries cataloged at home, work or at both
  2659.        locations.  
  2660.      * Listings can be directed to the screen, printer or file.
  2661.      * Listings can be interrupted by pressing the ESC key.
  2662.      * Screen listings pause until any key is pressed.  
  2663.      * Listings carry a date/time stamp and headings.  
  2664.      * Retrieval list can be sorted in reverse chronological order or user-
  2665.        modified to sort on any desired field.  
  2666.  
  2667.                                   TO USE DBS-KAT
  2668.  
  2669.      Insert the DBS-KAT diskette in drive A:.  Then type the following:
  2670.      TYPE  A:READ.ME    and press the ENTER key. Follow the instructions 
  2671.      given to print out the DBS-KAT user manuals.  The manuals have install 
  2672.      & usage instructions.  
  2673.      
  2674.                                       NOTES
  2675.      
  2676.      DB_VISTA is a trademark of RAIMA Corporation, 12201 SE Tenth St., 
  2677.      Bellevue, WA  98005 
  2678.      
  2679.      DBS-KAT was originally released under the name, PC-KAT.
  2680.      
  2681.               EVERYTHING DESCRIBED HERE IS ON THE ENCLOSED DISKETTE.  
  2682.                             THIS IS NOT DEMO SOFTWARE!
  2683.  
  2684.  
  2685.                                         =TC
  2686.  
  2687.  
  2688.  
  2689.                                     DBS-KAT (R)
  2690.  
  2691.                             The Easy, Practical, Super
  2692.                             Capacity Diskette Cataloger
  2693.                            And Hard Disk Archive Utility
  2694.  
  2695.  
  2696.                             TECHNICAL REFERENCE MANUAL
  2697.  
  2698.  
  2699.                                         by
  2700.                                     R.H. Martin
  2701.  
  2702.  
  2703.                               Applied Foresight Inc.
  2704.                                   P.O. Box 20607
  2705.                               Bloomington, MN  55420
  2706.  
  2707.                                   April 24, 1990
  2708.                                      Ver. 2.25
  2709.  
  2710.  
  2711.  
  2712.                         Copyright 1986, 1987 by R.H. Martin
  2713.                                 All Rights Reserved
  2714.  
  2715.  
  2716.  
  2717.                           A DB-SHAREWARE Software Product
  2718.  
  2719.  
  2720.  
  2721.                     A limited license is hereby granted to copy
  2722.                    & distribute wholly unmodified copies of the
  2723.                DBS-KAT Software Diskette which contains this manual
  2724.  
  2725.                    (Read the manual, "THE DB-SHAREWARE PROGRAM"
  2726.                    for full details about this limited license)
  2727.  
  2728.  
  2729.  
  2730.  
  2731.  
  2732.  
  2733.  
  2734.  
  2735.  
  2736.  
  2737.  
  2738.           DBS-KAT TECH REF MANUAL      Copyright 1986 R.H. Martin      P. 2
  2739.  
  2740.  
  2741.  
  2742.                                  TABLE OF CONTENTS
  2743.  
  2744.      Table of Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
  2745.      About This Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
  2746.      Efficiency Of DBS-KAT. . . . . . . . . .. . . . . . . . . . . . . . . . 3
  2747.      DBS-KAT Inquiry Search Strategies . . . . . . . . . . . . . . . . . . . 5
  2748.      Recovering Your Database. . . . . . . . . . . . . . . . . . . . . . . . 7
  2749.      Upgrading A PC-KAT/Pre-2.0 DBS-KAT Database . . . . . . . . . . . . . . 9
  2750.      DBS-KAT Version History . . . . . . . . . . . . . . . . . . . . . . . .11
  2751.  
  2752.  
  2753.                                  ABOUT THIS MANUAL
  2754.  
  2755.      With the exception of the Registration Benefits section, this manual
  2756.      restricts itself to the base DBS-KAT software diskette.  The concept of
  2757.      "base software" is discussed in greater detail in the THE DB-SHAREWARE
  2758.      PROGRAM manual.
  2759.  
  2760.      A section is designated by a centered & underlined heading.  Centered but
  2761.      NOT underlined headings are referred to as a subsection.
  2762.  
  2763.  
  2764.           DBS-KAT TECH REF MANUAL      Copyright 1986 R.H. Martin      P. 3
  2765.  
  2766.  
  2767.                                EFFICIENCY OF DBS-KAT
  2768.  
  2769.      DBS-KAT is fast & efficient, minimizing the amount of disk space required
  2770.      to store the cataloged information.  Each date & time field is con-
  2771.      catenated together & stored as a 4 byte long integer.  In plain words,
  2772.      what you see on the screen as 10 bytes of information is stored in 4
  2773.      bytes of storage.  The four byte volume ID is stored as a 2 byte integer.
  2774.      If a diskette filename is associated with a floppy subdirectory, the
  2775.      directory name is separately stored in the database only once in its
  2776.      alphabetical description form, & given an ID number.  This ID number is
  2777.      carried in the appropriate individual filename records.
  2778.  
  2779.      The entire DBS-KAT database is kept in the files prefixed as KATDB.DA &
  2780.      KATDB.KE.  The database contains the system control record, the diskette
  2781.      volume text information & the directory file information for all
  2782.      cataloged files.  In addition, all the record pointers are stored in the
  2783.      database to allow quick updating & retrieval of information.   The file
  2784.      KATDB.DBD is the data base structure dictionary which never grows but is
  2785.      needed for the programs to work & must reside in the same directory area
  2786.      on the hard disk alongside the other KATDB files.
  2787.  
  2788.      What this means is that although DBS-KAT must keep its inter-
  2789.      relationships connected at the disk drive level versus smaller packages
  2790.      which do most of their inter-relationships at runtime in memory, DBS-KAT
  2791.      does not use up hardly any more disk space, & that is because of its
  2792.      efficient use of disk space.  Additionally, DBS-KAT has to allow for its
  2793.      database pointers to expand up to 16 million records.  What this means is
  2794.      that on the average, DBS-KAT uses up only 7 percent more space per
  2795.      cataloged directory entry than does its competitors.
  2796.  
  2797.      The other packages gain their processing efficiency by storing the entire
  2798.      database in memory at run time.  That is why they can't get larger,
  2799.      because they are constrained by available program data memory space.
  2800.      Yet, without significantly sacrificing additional disk space, DBS-KAT
  2801.      uses disk space to hold its pointers, & achieves comparable processing
  2802.      efficiency on a catalog database capable of holding 16 million records.
  2803.  
  2804.      The author maintains for himself a DBS-KAT database of over 18,000
  2805.      filenames & around eight hundred diskettes.
  2806.  
  2807.      Throughout the built-up of this database, the author has not noticed a
  2808.      worsening of processing performance, except that a display request for a
  2809.      floating substring phrase within any & all cataloged filenames does take
  2810.      a little longer as the database grows.  To use the DOS DIR command syntax
  2811.      to explain this type of search request, although DOS does not honor such
  2812.      a search request, if it did, a request might look like this: DIR *CAT*.
  2813.      On a COMPAQ PLUS, with 8,000 filenames in a DBS-KAT database, it takes
  2814.      under 2 minutes for such a search to finish, whereas with 6,000
  2815.      filenames, it takes under 1.5 minutes.  Search requests for left-hand
  2816.      anchored substring phrases within any & all cataloged filenames is
  2817.      extremely rapid, taking only a couple of seconds to fulfill.  A search
  2818.      request at the DOS DIR level might look like: DIR CAT*.
  2819.           DBS-KAT TECH REF MANUAL      Copyright 1986 R.H. Martin      P. 4
  2820.  
  2821.  
  2822.  
  2823.      DBS-KAT is fast because of the tools used in developing DBS-KAT (dis-
  2824.      cussed earlier) & because of its streamlined design.  For instance, if
  2825.      you have a diskette previously cataloged by DBS-KAT, when you change, add
  2826.      or delete a few files on the diskette, DBS-KAT concentrates on these mod-
  2827.      ifications.  A less efficient design might start out the processing of
  2828.      each diskette with the deletion of all prior database information for
  2829.      that diskette.  Because of DBS-KAT's usage of the sophisticated DB-VISTA
  2830.      database manager, it is able to immediately access prior information for
  2831.      the at-hand diskette in the correct processing order in which it needs
  2832.      it.  Finally, DBS-KAT is fast because it allows the user to use a RAM
  2833.      disk emulator to store the subprograms & work files for DBS-KAT on the
  2834.      RAM disk.
  2835.  
  2836.      DBS-KAT is also fast because it is smart.  If you mistakenly insert a
  2837.      diskette which hasn't changed since it was last processed by DBS-KAT, you
  2838.      are told this is the case.  DBS-KAT keeps for each diskette both a
  2839.      numeric total of the number of files on the diskette plus the sum of all
  2840.      dates + all times + all file sizes of all the files on the diskette.
  2841.      Before DBS-KAT considers updating directory entries for a diskette, it
  2842.      compares these two new totals with the prior run's old totals.
  2843.  
  2844.  
  2845.           DBS-KAT TECH REF MANUAL      Copyright 1986 R.H. Martin      P. 5
  2846.  
  2847.  
  2848.                                         =TS
  2849.  
  2850.                          DBS-KAT INQUIRY SEARCH STRATEGIES
  2851.  
  2852.      To understand the many ways you can search your DBS-KAT database & how
  2853.      efficient will be your search, you need to know how your DBS-KAT database
  2854.      is structured.  For searching purposes, you can think of the database
  2855.      being ordered in two different ways:
  2856.  
  2857.      (a) by alphabetical, indexed, order by FILENAME.EXT, regardless of the
  2858.          volume ID; &
  2859.      (b) by numeric, indexed, order by volume ID, & within volume ID order,
  2860.          subordered alphabetically, by FILENAME.EXT.
  2861.  
  2862.      The path information is carried in the database, but it has no ordering
  2863.      effect in terms of aiding retrieval of information.
  2864.  
  2865.      Based upon the structure of DBS-KAT's database design, the following
  2866.      examples represent a range of searchs ordered by a most efficient search
  2867.      argument to a least efficient search argument:
  2868.  
  2869.          FILENAME ARGUMENT TYPE   EXT ARGUMENT TYPE   PATH/NOTE ARG TYPE
  2870.          --------          -      ---          -      --------      -
  2871.          MYFILE            E      DOC          E      MYPATH        E
  2872.          MYFILE            E      DOC          E      MY            A
  2873.          MYFILE            E      DOC          E      AT            U
  2874.          MYFILE            E      D            A      <left blank>
  2875.          MYFILE            E      O            U      <left blank>
  2876.          MYFILE            E      <left blank>        <left blank>
  2877.          MY                A      DOC          E      MYPATH        E
  2878.          MY                A      DOC          E      MY            A
  2879.          MY                A      DOC          E      AT            U
  2880.          MY                A      D            A      <left blank>
  2881.          MY                A      O            U      <left blank>
  2882.          MY                A      <left blank>        <left blank>
  2883.          FIL               U      DOC          E      MYPATH        E
  2884.          FIL               U      DOC          E      MY            A
  2885.          FIL               U      DOC          E      AT            U
  2886.          FIL               U      D            A      <left blank>
  2887.          FIL               U      O            U      <left blank>
  2888.        * FIL               U      <left blank>        <left blank>
  2889.       ** <left blank>             DOC          E      MYPATH        E
  2890.          <left blank>             DOC          E      MY            A
  2891.          <left blank>             DOC          E      AT            U
  2892.          <left blank>             D            A      <left blank>
  2893.          <left blank>             O            U      <left blank>
  2894.          <left blank>             <left blank>        MYPATH        E
  2895.          <left blank>             <left blank>        MY            A
  2896.          <left blank>             <left blank>        AT            U
  2897.  
  2898.      Don't be afraid to use the search strategy you need to accomplish the job
  2899.      you want done.  For instance, against a database of 12,000 directory
  2900.           DBS-KAT TECH REF MANUAL      Copyright 1986 R.H. Martin      P. 6
  2901.  
  2902.  
  2903.      entries, to search using an argument like the above line with an asterick
  2904.      preceeding it, took around two & a half minutes.  This search argument
  2905.      causes the entire database keyfile to be scanned from start to end.  The
  2906.      last three searches are the most disk intensive types of searches, as
  2907.      they cause the entire database keyfile and datafiles to be scanned from
  2908.      start to end.
  2909.  
  2910.      Search strategies beginning with the double astericked line are sig-
  2911.      nificantly slower than those above it.  These search strategies involve
  2912.      intensive disk accessing.  That is because both the key and data record
  2913.      must be read from disk for every database record in order to be con-
  2914.      sidered for retrieval.  For search strategies before the double-
  2915.      astericked line, the data record was hardly ever accessed if at all.
  2916.  
  2917.  
  2918.           DBS-KAT TECH REF MANUAL      Copyright 1986 R.H. Martin      P. 7
  2919.  
  2920.  
  2921.                                         =TR
  2922.  
  2923.                              RECOVERING YOUR DATABASE
  2924.  
  2925.      "Into each life a little rain must fall."  It can happen to one's
  2926.      database too.  Recovery should be done when you loose your hard disk or
  2927.      when something has damaged your database.  In either case, the database
  2928.      recovery procedure is the same.  True, you have to restore everything
  2929.      else in a hard disk failure, but you're on your own to figure that
  2930.      dilemna out.  Just the database recovery procedure is documented here.
  2931.      Follow these procedures.
  2932.  
  2933.      #   ACTION  EVENT OR COMMAND                      COMMENT
  2934.      --  ------  ----------------------------------    -----------------------
  2935.      1   Type    C:                                    Move to your hard disk.
  2936.  
  2937.      2   Type    CD \                                  Move to the root
  2938.                                                        directory.
  2939.  
  2940.      3   Type    VERIFY ON                             Ensure better file
  2941.                                                        copies.
  2942.  
  2943.      4   Type    COPY KATDB.LOG KATDB.FIX              Save current log file.
  2944.  
  2945.      5   Type    KATLOG                                Print your current log
  2946.                                                        file.
  2947.  
  2948.      6   Find    Latest DBS-KAT database backup disks  Insert disk 1 into
  2949.                                                        drive.
  2950.  
  2951.      7   Type    RESTORE A: C:KATDB.*                  Restore old DBS-KAT
  2952.                                                        database.
  2953.  
  2954.      8   Do      DBS-KAT Integrity Analysis if not     If integrity fails go
  2955.                  using a "VERIFIED" backup set.        back to step 5.
  2956.  
  2957.      9   Read    KATLOG printout for line # of B/U state which you're restored
  2958.                  to.  Call this number "RESTORE-LINENUM".
  2959.  
  2960.      10  Read    KATLOG printout for last line # of printout.  Call this
  2961.                  number "LAST-LINENUM".
  2962.  
  2963.      11  Calc    Write down what LAST-LINENUM minus RESTORE-LINENUM equals.
  2964.                  Call this number STRIP-LINENUM.
  2965.  
  2966.      12  Type    KATSTRIP STRIP-LINENUM                Substitute real number.
  2967.                                                        KATDB.FIX now contains
  2968.                                                        an unsorted list of
  2969.                                                        disks to reprocess.
  2970.  
  2971.      13  Type    SORT <KATDB.FIX >PRN                  This printout is sorted
  2972.                                                        by yet-to-redo volume
  2973.                                                        ID within location.
  2974.           DBS-KAT TECH REF MANUAL      Copyright 1986 R.H. Martin      P. 8
  2975.  
  2976.  
  2977.  
  2978.      14  DO      KAT -U or some variation              Reprocess listed dis-
  2979.                                                        kettes.
  2980.  
  2981.      15  Type    DEL KATDB.FIX                         No longer needed.
  2982.  
  2983.      You're done!  Consider doing a DBS-KAT Integrity Analysis & Backup to
  2984.      preserve the recovery work you just went through.
  2985.  
  2986.  
  2987.           DBS-KAT TECH REF MANUAL      Copyright 1986 R.H. Martin      P. 9
  2988.  
  2989.  
  2990.                                         =TU
  2991.  
  2992.                     UPGRADING A PC-KAT/PRE-2.0 DBS-KAT DATABASE
  2993.  
  2994.      Raima Corporation, the developer of DB_VISTA, which is the database
  2995.      manager used by DBS-KAT, found some rare occurring problems with 2.10 of
  2996.      DB-VISTA, which was used for PC-KAT and pre-2.0 versions of DBS-KAT.  DB-
  2997.      VISTA release 2.11 and 2.21 was released to fix rare occurring problems.
  2998.      These problems were so rare under 2.10, that I never noticed anything
  2999.      amiss except once after processing 18,000 filenames and nearly 900 dis-
  3000.      kettes.  I never noticed anything wrong with DB_VISTA 2.11.  DBS-KAT
  3001.      releases as of 2.0 use DB_VISTA 2.11.  DBS-KAT releases as of 2.20 use
  3002.      DB_VISTA 2.21.
  3003.  
  3004.      Aside from updated programs, there is no database update requirement
  3005.      going from DBS-KAT 2.0 through 2.10 up to DBS-KAT 2.23.  For pre-2.0 DBS-
  3006.      KAT databases, there are two ways to upgrade your existing database:
  3007.  
  3008.         1.  Send $10.00 US (foreign users add $10 US) to Applied Foresight,
  3009.             Inc. for a diskette with a DB_VISTA database rebuild program and a
  3010.             DB_VISTA database consistency checkout program, along with
  3011.             instructions on how to use them.  This approach costs money but
  3012.             involves no manual re-entry of database information.  Use the
  3013.             KAT -O option to printout an order form to place your order.
  3014.  
  3015.             OR ELSE
  3016.  
  3017.         2.  Build up from scratch a brand new, post-release DBS-KAT 2.X
  3018.             database.  To do this, follow the steps below.  If you have less
  3019.             than 100 diskettes, you'll find that this isn't all that bad of a
  3020.             task and it will save you the money to pursue option 1.  Option 1
  3021.             however will provide you with a database rebuild program
  3022.             (KEYBUILD) and consistency checkout program (DBCHECK) which is
  3023.             fast and thorough, as they were written by the developers of
  3024.             DB_VISTA.  With these programs, you can forever more bypass the
  3025.             DBS-KAT specific integrity analysis procedure, which is not as
  3026.             thorough as DB_VISTA's DBCHECK program.  Raima corporation has
  3027.             authorized Applied Foresight Inc. to offer these programs to its
  3028.             customers.
  3029.  
  3030.      To perform step 2, you need to perform the following steps:
  3031.  
  3032.  
  3033.      #   ACTION  EVENT OR COMMAND                      COMMENT
  3034.      --  ------  ----------------------------------    -----------------------
  3035.      1   Type    C:                                    Move to your hard disk.
  3036.  
  3037.      2   Type    CD \                                  Move to the root
  3038.                                                        directory if DBS-KAT
  3039.                                                        was installed there,
  3040.                                                        else move to the
  3041.                                                        directory where DBS-KAT
  3042.                                                        resides.
  3043.           DBS-KAT TECH REF MANUAL      Copyright 1986 R.H. Martin      P. 10
  3044.  
  3045.  
  3046.  
  3047.      3   Type    VERIFY ON                             Ensure better file
  3048.                                                        copies.
  3049.  
  3050.      4   Type    KATLOOK -M                            Look at your existing
  3051.                                                        System Control Record
  3052.                                                        setup information and
  3053.                                                        using the PrtSc key,
  3054.                                                        record how it is
  3055.                                                        already setup.
  3056.  
  3057.      5   Type    KATLOOK                               Print out a list of
  3058.                                                        the cataloged volumes
  3059.                                                        that you already have,
  3060.                                                        along with their des-
  3061.                                                        cription.
  3062.  
  3063.      6   Choose option 4 & have it go to P(rinter)     To get a "Listing of
  3064.                                                        cataloged diskette
  3065.                                                        volumes" of your pre-
  3066.                                                        2.0 DBS-KAT database.
  3067.  
  3068.      7   DO      Delete all old DBS-KAT or PC-KAT files off your hard disk.
  3069.                  (Do not undo nor delete whatever is in CONFIG.SYS or your
  3070.                  AUTOEXEC.BAT files; nor should you delete whatever DOS pro-
  3071.                  grams were needed to work with your old DBS-KAT.)
  3072.  
  3073.                                                        For example, in the
  3074.                                                        directory where you
  3075.                                                        previously installed
  3076.                                                        DBS-KAT, type:
  3077.                                                        DEL KAT*.*
  3078.  
  3079.      8   Insert DBS-KAT 2.X diskette in drive A:.
  3080.  
  3081.      9   Follow DBS-KAT 2.X manual instructions to install DBS-KAT.
  3082.  
  3083.      10  Type:   KATLOOK -M                            Update your System
  3084.                                                        Control Record similar
  3085.                                                        to your old one, as
  3086.                                                        given by the Print
  3087.                                                        Screen done above under
  3088.                                                        step 4.
  3089.  
  3090.      11  Type:   KAT -U                                Process every diskette
  3091.                                                        listed under step 6
  3092.                                                        above.  Update the
  3093.                                                        volume header database
  3094.                                                        record for each dis-
  3095.                                                        kette with the printout
  3096.                                                        information.
  3097.  
  3098.           DBS-KAT TECH REF MANUAL      Copyright 1986 R.H. Martin      P. 11
  3099.  
  3100.  
  3101.      12  You're done!  Consider backing up this database now.  Back up the
  3102.          database from inside KAT -U program with the "B" option.
  3103.  
  3104.  
  3105.  
  3106.                                         =TH
  3107.  
  3108.                               DBS-KAT VERSION HISTORY
  3109.  
  3110.      REL.  CATEGORY CHG.  WHEN  COMMENT-------------------------------------
  3111.  
  3112.      1.0   BETA RELEASE   6/85  Not released to general public.
  3113.      1.1   BETA UPDATE    6/85  " ".
  3114.      1.2   PUBLIC REL.    1/86  First public release under PC-KAT name.
  3115.      1.2A  RARE BUG FIX   1/86  If diskette had multiple directories on it,
  3116.                                 1.2 occassionally would abort.
  3117.      1.2B  RARE BUG FIX   1/86  Improvement upon 1.2A fix; changing all
  3118.                                 copyright statements to 1986 year.
  3119.      1.2C  COSMETIC FIX   2/86  KATLOOK handled printer formfeed wrong when
  3120.                                 doing multi-page volume header subselection
  3121.                                 retrieval; added version history notes;
  3122.                                 shortened novice install instructions.
  3123.      1.3   NAME CHANGE    2/86  Product renamed DBS-KAT.
  3124.      1.3A  NAME CHANGE &  3/86  DB-SHARE concept renamed DB-SHAREWARE &
  3125.            UPD.ENHANCE.         Improved support for cataloging remove-
  3126.                                 able disk cartridges.
  3127.      1.3B  UPD.ENHANCE.   4/86  Support cataloging non-std disk labels.
  3128.      1.4   INQ.ENHANCE.   5/86  Support inquiry against ext.path/note field.
  3129.      1.4A  COSMETIC CHG   5/86  If DB not in root but present, don't CD \.
  3130.      2.0   DB_VISTA UPD & 7/86  Update from 2.1 to 2.11 DB_VISTA.  Added new
  3131.            ADDED KATSCAN        programs, KATASK & KATSCAN, & updated KPRINT.
  3132.      2.01  SRCH BY SUBDIR 2/87  Allow KATLOOK to search by user providing
  3133.                                 subdirectory name if cataloged file resides
  3134.                                 in a subdirectory.
  3135.      2.02  COSMETIC FIX   4/87  Recognize IAMNOTAN.IBM in curr. or \ dir.
  3136.      2.10  SEVERAL CHGS   7/87  Converted from Lattice C, Ver. 2.15 to 3.10;
  3137.                                 DOS 3.X required now; Reads vol. label
  3138.                                 directory directly, so European DOS users
  3139.                                 should be supported now; Support installation
  3140.                                 of DBS-KAT in \DBSKAT subdirectory; & returns
  3141.                                 user to original subdirectory when done.
  3142.      2.20  DBMS/C UPDATE  1/89  Update to Lattice 3.21 & DB_Vista 2.21; does
  3143.                                 not affect database structure; should reduce
  3144.                                 occurrences of database corruption.  Also 2
  3145.                                 new capabilities added to option 3 of KATLOOK.
  3146.      2.21  FIX+USE PKZIP  8/89  Fix rare KAT update bug when updating a dis-
  3147.                                 kette in which old files were changed to new
  3148.                                 diskette subdirectories (the bug would display
  3149.                                 "db_VISTA database error -21 - field is sort
  3150.                                 field of connected record; ... SUBR:
  3151.                                 do_mrpass, DB_CALL: d_recwrite &ver...").
  3152.                                 Also use PKZIP for installing.
  3153.           DBS-KAT TECH REF MANUAL      Copyright 1986 R.H. Martin      P. 12
  3154.  
  3155.  
  3156.      2.22  NEW PKZIP      8/89  Use newer version of PKZIP.
  3157.      2.23  REDO 2.21 FIX  9/89  Redo fix made in 2.21.
  3158.      2.24  ADD LIST.COM   4/90  Support Online Manual Access.
  3159.      2.25  CHG LIST TO ML 4/90  Although written permission from Vernon Buerg
  3160.                                 was obtained to use LIST.COM & LIST.DOC for
  3161.                                 version 2.24, the wording inside LIST.DOC made
  3162.                                 too many sysops/shareware distributors
  3163.                                 hesitant to distribute it.  ML (Mouse Lister)
  3164.                                 was found to be an excellent replacement & its
  3165.                                 documentation is less imposing on dis-
  3166.                                 tributors, as well as it's author, Gil Yoder,
  3167.                                 also agreed to allow distribution of his file
  3168.                                 viewing software & documentation with DBS-KAT.
  3169.                                 DBS-KAT[r] DATABASE INTEGRITY                   =DI
  3170.  
  3171.                            by Applied Foresight, Inc.
  3172.                                  P.O. Box 20607
  3173.                             Bloomington, Minn.  55420
  3174.                          (C) Copyright 1986 R.H. Martin.
  3175.                         All Rights Reserved.  TM pending
  3176.  
  3177.                                  April 19, 1990
  3178.  
  3179.      To DBS-KAT users:
  3180.  
  3181.      Several user letters have conveyed an interest in or concern about the
  3182.      integrity of their DBS-KAT database.  The database manager used by DBS-
  3183.      KAT is DB_VISTA[tm] by RAIMA Corporation, Bellevue, Washington.  It is a
  3184.      very solid database manager and the current release used by Applied
  3185.      Foresight is 2.21.  There are no known bugs with this release.  Under
  3186.      very rare circumstances, a prior version (2.11 used in DBS-KAT 2.0
  3187.      through 2.10), could theoretically cause a problem.  No known problems
  3188.      with DBS-KAT users were ever known to occur however.
  3189.  
  3190.      However, a bug in earlier versions of DBS-KAT appeared to users as if
  3191.      it were a corrupted database problem.  This bug would occur if users
  3192.      were using diskette subdirectories, and when updating a pre-cataloged
  3193.      diskette, if any of the files were changed to different-named
  3194.      subdirectories, the bug would appear.  The abort would display:
  3195.         "*** db_VISTA database error -21 - field is sort field of connected
  3196.         record ... SUBR: do_mrpass, DB_CALL: d_recwrite &ver, STATUS 1..."
  3197.      If the error occured under these circumstances, the database is not
  3198.      corrupted.  One only needs to run version 2.22 or newer of DBS-KAT to
  3199.      successfully process the "problem-causing" diskette.
  3200.  
  3201.      Something to be aware of, however, is a documentation shortcoming in
  3202.      older DBS-KAT's manuals.  One should not run the DBS-KAT integrity
  3203.      check routine in the KATLOOK or KAT -D (two ways to accomplish the
  3204.      same thing), without first cataloging a diskette (or removeable
  3205.      cartridge).  Performing this routine on an uncataloged database
  3206.      results in the message: "db_VISTA database error -19 - record not
  3207.      legal member of set.  d_setmr failed in c_dirline for CTRL01.  DB
  3208.      status = -19."  The database is okay.  It just needs at least one
  3209.      volume cataloged first.
  3210.  
  3211.      [Note: if one get this message after cataloging one volume, check if
  3212.      the database was installed in two places on the computer (eg, in \ and
  3213.      \KAT).  Perhaps the cataloged volume was added to the database in one
  3214.      directory and the analysis was done on the database in the other
  3215.      directory.  With the current release of DBS-KAT, the author has not
  3216.      been able to generate the -19 error message except on a database with
  3217.      no cataloged volumes.]
  3218.  
  3219.      There was a rare occurring bug in versions prior to 2.11 of DB-VISTA
  3220.      and users of DBS-KAT before release 2.0 are advised to follow the
  3221.      advise given in the release 2.0 DBS-KAT Technical Manual.  (It is okay
  3222.      to update from a pre-2.0 version to 2.20 and bypass 2.10 of DBS-KAT.)
  3223.      If you used DBS-KAT prior to release 2.0, did you follow those
  3224.      instructions explicitly?  This document stated that you were basically
  3225.      given two routes to go to update your database: (1) purchase for $6.50
  3226.                           DBS-KAT DATABASE INTEGRITY - Page 2
  3227.      
  3228.      the DB_VISTA database utilities (DBCHECK and KEYBUILD) and follow
  3229.      Applied Foresight's instructions for upgrading to 2.0 (or greater of)
  3230.      DBS-KAT or (2) install release 2.0 (or greater of) of DBS-KAT and
  3231.      rebuild from scratch a new DBS-KAT data base.  Use the DBS-KAT order
  3232.      form (type: KAT -O to print it out) to order these two utility
  3233.      programs.   Note: DBS-KAT registration entitles one to the database
  3234.      utilities diskette.
  3235.  
  3236.      The DBS-KAT database is made up of four components:
  3237.  
  3238.      1.  The DBS-KAT database dictionary file, KATDB.DBD.  It never changes
  3239.          and can be rebuilt by going back to the original file from your
  3240.          original (latest version) DBS-KAT diskette.
  3241.  
  3242.      2.  The DBS-KAT database key files, KATDB.KE? files.  They can be
  3243.          rebuilt by running the KEYBUILD utility program (see below).
  3244.          There are four DBS-KAT key files: (a) one for each diskette volume
  3245.          ID, (b) one for each diskette filename entry, (c) one for each
  3246.          diskette-contained subdirectory name, and (d) one for the numeric
  3247.          ID DBS-KAT assigns for each diskette-contained subdirectory name.
  3248.  
  3249.      3.  The DBS-KAT set pointers, which are contained alongside each data
  3250.          record.  The only DBS-KAT set is the diskette volume set, which
  3251.          has a parent record for each diskette cataloged and a zero-to-many
  3252.          number of child records for each parent record representing the
  3253.          number of filenames associated with that diskette.
  3254.  
  3255.          The set pointers for each child record are: (a) pointer to parent
  3256.          record, (b) pointer to prior sibling record, (c) pointer to next
  3257.          sibling record.  The set pointers for each parent record are: (d)
  3258.          total number of children (not really a pointer), (e) pointer to
  3259.          first child (lowest alphabetical diskette filename), and (f)
  3260.          pointer to last child (highest alphabetical diskette filename).
  3261.  
  3262.      4.  The DBS-KAT end-user data, which is kept in the database in the
  3263.          form of data records.  Alongside each database record, however,
  3264.          are set pointers (discussed previously).
  3265.  
  3266.      The built-in integrity checking of DBS-KAT's base system diskette only
  3267.      works the DBS-KAT keyfiles and the first type (a) set pointer.  The
  3268.      majority of database damage will cause this built-in checking to spot
  3269.      it.  Very rarely will a damaged database pass this built-in integrity
  3270.      checking for rarely is database damage solely limited to damaged set
  3271.      pointers, type (b) through (f).  However, if the only database damage
  3272.      is missing entries in the DBS-KAT keyfile (b), the built-integrity
  3273.      checking of DBS-KAT will not detect this damage.
  3274.  
  3275.      Because very rare database damage can slip by the built-in integrity
  3276.      checking provided by the base system diskette of DBS-KAT, Applied
  3277.      Foresight Inc. provides the optional database utility diskette.
  3278.      Applied Foresight believes all users should get this diskette and is
  3279.      therefore making it available for only a small handling and mailing
  3280.      cost.  The utility software is not ShareWare and is discussed in more
  3281.      detail below.
  3282.  
  3283.                           DBS-KAT DATABASE INTEGRITY - Page 3
  3284.      
  3285.      Database damage can occur when:
  3286.  
  3287.      a. A user operates his computer under abnormal power conditions
  3288.         (undervoltages/overvoltages occurring).  Tripp-Lite Manufacturing
  3289.         out of Chicago makes an affordable voltage regulator for $219
  3290.         (retail), called the LC-1200.
  3291.  
  3292.      b. A user operates his computer under abnormal high static
  3293.         electricity.  Buy just about any type of static electricity
  3294.         preventive device.
  3295.  
  3296.      c. Badly-behaving background memory programs are causing damage (none
  3297.         yet known to Applied Foresight's knowledge).
  3298.  
  3299.      d. The User's file directory is corrupt.  (Run the DOS program, CHKDSK
  3300.         /F to see if your directory is corrupt.  If it is, answer "Y" to
  3301.         the prompt.  Rerun afterwards if an error is detected to see if the
  3302.         /F (fix) option cleaned it up.)
  3303.  
  3304.      e. The database ends up sitting on a bad part of a user's disk drive.
  3305.         Norton's program, DISKTEST (or DT) may remedy this problem, as long
  3306.         as the bad file detected isn't a DBS-KAT database file.
  3307.  
  3308.      f. The user intentionally or unintentionally aborts out of an update
  3309.         function of DBS-KAT, and a user does not do the prescribed DBS-KAT
  3310.         recovery, as documented in the base system DBS-KAT Technical
  3311.         Reference manual.
  3312.  
  3313.         For example, the user midway through an update of a diskette
  3314.         discovers he has used the wrong volume number and presses CTRL-C or
  3315.         CTRL-BREAK.  This can cause a corrupted database.  Only exit the
  3316.         DBS-KAT update routines in a normal manner.
  3317.  
  3318.      g. The user is using a computer which has an unsynchronized operating
  3319.         system.  That is, COMMAND.COM, IBMBIO.COM (IO.SYS on some clones),
  3320.         IBMDOS.COM (MSDOS.SYS on some clones), do not all belong to the
  3321.         same operating system.  This situation develops when a user updates
  3322.         to a newer operating system by only using the DOS copy command.  To
  3323.         see if your system is in synch, do the following:
  3324.  
  3325.         At the root directory of the drive you boot up on, type:
  3326.         KATSCAN  *.*  and press ENTER.  As soon as the first three file
  3327.         entries appear, press the CTRL-BREAK key to abort the display.  The
  3328.         first two filenames should have "SYS" appearing in the far right
  3329.         hand column of the KATSCAN display.  The third filename should be
  3330.         COMMAND.COM.  Do a SHIFT-PRTSC print-screen of this display.
  3331.         Repeat this procedure on your original DOS diskette.  Compare the
  3332.         filesizes and dates to make sure everything compares ok.
  3333.  
  3334.         If the operating system is not in synch, perform the following
  3335.         steps to take the absolute safest steps to clean up your system.
  3336.         If you don't know how to do the below, consult either your computer
  3337.         manuals for more detailed instructions or a local computer dealer
  3338.         to help you do this.
  3339.  
  3340.                           DBS-KAT DATABASE INTEGRITY - Page 4
  3341.      
  3342.         1)  Type:  KATSCAN and press ENTER.
  3343.  
  3344.             Use "*.*" as the file set to scan and "P" for the redirection
  3345.             option.  This will print out how your fixed disk is setup.
  3346.             Consult the KATSCAN operation documentation for more
  3347.             information.
  3348.  
  3349.         2)  Delete all old DOS programs from your disk drive.  Use the DIR
  3350.             command against your DOS diskette to figure out what the
  3351.             filenames are.
  3352.  
  3353.         3)  Restart your computer using the DOS diskette that you want to
  3354.             upgrade or reinstall with.  Make sure it has the write-enable
  3355.             notch taped over.  Type:  BACKUP  C:\*.*  A:/S  and press
  3356.             ENTER.  This will backup all non-DOS files on drive C:.
  3357.  
  3358.             Note: When prompted, remove DOS diskette and insert first
  3359.             formatted diskette which you will use to backup your computer.
  3360.  
  3361.         4)  Type:  FDISK  and press ENTER and choose the option to Remove
  3362.             your DOS partition.
  3363.  
  3364.             Some manuals will tell you that all you have to do is use SYS:
  3365.             and COPY commands to update your operating system.  This isn't
  3366.             always true, depending on the version of DOS and the brand.  I
  3367.             have upgraded hundreds of computers and the method given here
  3368.             is the safest.
  3369.  
  3370.         5)  Turn off your computer, wait 1 minute.  Put your new DOS
  3371.             diskette in drive A: and turn computer back on.
  3372.  
  3373.         6)  Type:  FDISK  and press ENTER and choose the option to Install
  3374.             DOS partition.  Use the entire drive.
  3375.  
  3376.         7)  Type:  FORMAT  C:/S  and press ENTER to format your hard disk
  3377.             as a bootable device.
  3378.  
  3379.         8)  Type:  MD \DOS  and press ENTER to create a directory to hold
  3380.             your DOS programs.
  3381.  
  3382.         9)  Type:  COPY  A:*.*  C:\DOS /V  and press ENTER to install all
  3383.             your original DOS programs to the \DOS directory.
  3384.  
  3385.             Afterwards, type:  DEL C:\DOS\COMMAND.COM and press ENTER, to
  3386.             avoid duplicates.
  3387.  
  3388.         10) Insert diskette 1 of your backup set in drive A:.
  3389.  
  3390.             Type:  CD  \DOS  and press ENTER.
  3391.  
  3392.             Type:  RESTORE  A:  C:\*.* /S/P  and press ENTER.
  3393.  
  3394.             This will restore everthing that isn't already on the new setup
  3395.             drive C:.  When prompted if you want to overwrite a file,
  3396.             answer "N".
  3397.                           DBS-KAT DATABASE INTEGRITY - Page 5
  3398.      
  3399.         11) Very important: verify that your CONFIG.SYS file has a line,
  3400.             FILES=20, in it.  Type:  TYPE  C:\CONFIG.SYS  and press ENTER.
  3401.  
  3402.             If it doesn't, reread DBS-KAT install instructions pertaining
  3403.             to CONFIG.SYS and AUTOEXEC.BAT.
  3404.  
  3405.             Note: Refer back to the DBS-KAT install instructions for Novice
  3406.             Users to make sure that your reinstalled \AUTOEXEC.BAT file
  3407.             complies with your new environment (ie, your old DOS files
  3408.             might not have been in a directory called \DOS).
  3409.  
  3410.             When you've verified that CONFIG.SYS is setup okay, remove all
  3411.             diskettes from drive A: and restart your computer.  DO NOT SKIP
  3412.             THIS RESTART!
  3413.  
  3414.      h. The software which updates the database has a serious bug which can
  3415.         cause database integrity to be lost.  HOWEVER, to the best of
  3416.         Applied Foresight's knowledge, there are no bugs in DBS-KAT
  3417.         software which can cause this type of damage, AND to the best of
  3418.         RAIMA Corporation's knowledge, there are no bugs in DB_VISTA 2.11
  3419.         software which can cause database damage.
  3420.  
  3421.      i. The DBS-KAT software program has become corrupted because of a poor
  3422.         file copy, bad disk drive, or corrupted file directory.  Compare
  3423.         the DBS-KAT software on your fixed disk with your original DBS-KAT
  3424.         software diskette, using the DOS command COMP.  Since DBS-KAT uses
  3425.         compressed programs, you would have to save your existing DBS-KAT
  3426.         programs (using the DOS COPY command) to a blank diskette, and
  3427.         reinstall the DBS-KAT programs (only the programs!).  Afterwards,
  3428.         you'd type:  COMP KAT*.EXE  A: and press ENTER to compare the DBS-
  3429.         KAT programs on your fixed disk with those earlier copied to
  3430.         diskette prior to the reinstall.
  3431.  
  3432.  
  3433.                     THE DBS-KAT(TM) DATABASE UTILITY PROGRAMS             =DU
  3434.  
  3435.     Use of the DBS-KAT utility diskette programs are provided under written
  3436.     license to Applied Foresight, Inc., by RAIMA Corporation. These
  3437.     programs, KEYBUILD and DBCHECK are not ShareWare programs and you are
  3438.     not authorized to distribute these programs to other persons.  The
  3439.     written license allows Applied Foresight to distribute these diskettes
  3440.     to DBS-KAT owners who arrange with Applied Foresight, Inc., to receive
  3441.     them.  Support for these two programs for DBS-KAT users is only through
  3442.     Applied Foresight, Inc.  Do NOT CONTACT RAIMA Corporation for support.
  3443.     RAIMA Corporation only provides support for those customers who have
  3444.     PURCHASED a RAIMA product.
  3445.  
  3446.     Instructions for running these programs are supplied when one purchases
  3447.     the utility diskette from Applied Foresight.
  3448.  
  3449.  
  3450.                         DATABASE CONSISTENCY CHECK UTILITY
  3451.  
  3452.     The DBCHECK database utility will perform the following consistency
  3453.     checks:
  3454.                           DBS-KAT DATABASE INTEGRITY - Page 6
  3455.      
  3456.     For each data file (KATDB.DA*):
  3457.  
  3458.     - Validate each record's record id number and database address. This
  3459.       will ensure that no garbage data or bad records have been written to
  3460.       a data file.
  3461.  
  3462.     - For each key field contained in each record, verify that the key does
  3463.       indeed exist.
  3464.  
  3465.       For each key file (KATDB.KE*):
  3466.  
  3467.       - Verify the number of slots used in each node. This will also check
  3468.         for garbage data.
  3469.  
  3470.       - Read the record associated with each key and verify that the
  3471.         contents of the key data field matches that stored on the key file.
  3472.  
  3473.     All database consistency errors are printed to "stdout" and give the
  3474.     location of the offending key or record.
  3475.  
  3476.  
  3477.                              KEY FILE BUILD UTILITY
  3478.  
  3479.     The utility KEYBUILD will rebuild all key files for the DBS-KAT
  3480.     database.  It rebuilds the key files by first initializing each key
  3481.     file and then scanning each record in each data file and reinserting
  3482.     all keys in the record.
  3483.  
  3484.     This utility can be used to recreate the key files when there's a
  3485.     database inconsistency (e.g. as reported by DBCHECK).
  3486.  
  3487.  
  3488.                                      SUMMARY
  3489.  
  3490.     The cautious user will purchase the DBS-KAT database integrity utility
  3491.     diskette and use the DBCHECK program 1-2 times a month to monitor the
  3492.     integrity of his database.
  3493.  
  3494.     If you discover with DBCHECK that you have a physically corrupt
  3495.     database, perform the following steps:
  3496.  
  3497.        1.  Run KEYBUILD to rebuild your database key files.
  3498.  
  3499.        2.  Run DBCHECK to see if the rebuilt database is clean.  If it is,
  3500.            your recovery is finished.  Backup this database and keep it
  3501.            around for awhile for safety sake.  Attempt to ask yourself what
  3502.            might have caused the damage and learn from your analysis.
  3503.  
  3504.        3.  Continue if your database is still damaged.
  3505.  
  3506.        4.  Per the recovery instructions in the base system DBS-KAT
  3507.            Technical Reference manual, restore to your last good DBS-KAT
  3508.            database backup.  (This includes getting a printout of your
  3509.            KATDB.LOG files of what diskettes have been processed since your
  3510.            last backup.)  Run DBCHECK to see if the recovered database is
  3511.                           DBS-KAT DATABASE INTEGRITY - Page 7
  3512.      
  3513.            clean.  If it is, reprocess the diskettes entered since your
  3514.            last backup and then your recovery is finished.  If your
  3515.            recovered database is damaged, then go to step 1 now.
  3516.  
  3517.         5. If you can't restore to a prior DBS-KAT database which is good,
  3518.            you'll have to reinstall DBS-KAT from scratch and rebuild your
  3519.            DBS-KAT database from scratch.
  3520.  
  3521.  
  3522.                                                                         =KS
  3523.              KATSCAN: The Hard Disk Archive Utility of DBS-KAT (R)           
  3524.  
  3525.                             by Applied Foresight, Inc.
  3526.                                   P.O. Box 20607
  3527.                             Bloomington, Minn.  55420
  3528.                       (C) Copyright 1986-1990 R.H. Martin.
  3529.                                All Rights Reserved.
  3530.  
  3531.      KATSCAN is a dual purpose utility program:
  3532.  
  3533.      * It is a stand-alone program for hard disk archiving which makes it
  3534.        easy for hard disk owners to manage & locate the files on their
  3535.        hard disk.
  3536.  
  3537.      * It has an undocumented function to support the cataloging functions
  3538.        of DBS-KAT, & for this purpose, it needs to be installed along
  3539.        with the other DBS-KAT software.
  3540.  
  3541.      KATSCAN can be prematurely aborted by pressing the ESC key.  If that
  3542.      doesn't work, then try pressing the BREAK key while holding down the
  3543.      CTRL key.
  3544.  
  3545.      KATSCAN is for 320 KB RAM computers which have a hard disk & PC-DOS
  3546.      or MS-DOS 2.00 or greater.
  3547.  
  3548.                            STAND-ALONE KATSCAN FEATURES
  3549.  
  3550.      KATSCAN can be ran identical to the DOS "DIR [file-search-string]"
  3551.      function.  When so ran, it will:
  3552.  
  3553.      * list all selected files & in what directories they exist on the
  3554.        default hard disk.
  3555.  
  3556.        Note: KATSCAN, if ran this way, can only search the default disk
  3557.        drive.
  3558.  
  3559.      * provide a fileset size subtotal per directory & per drive.
  3560.  
  3561.      KATSCAN can be ran without any command line options & the user will be
  3562.      prompted with a variety of options to choose from.  For each prompt,
  3563.      the user can take a shown default answer, or can type in an alternative
  3564.      answer.  User is:
  3565.  
  3566.      * Prompted for drive to search.
  3567.  
  3568.      * Prompted for a DOS "DIR [file-search-string].
  3569.  
  3570.      * Prompted if only files modified since last backup are to be selected.
  3571.  
  3572.        -> If "No" chosen, user is prompted if a date range is desired.
  3573.  
  3574.           - If the default ending date is not chosen, user is prompted if
  3575.             program files (.COM & .EXE) files are to be excluded.  Since
  3576.             program files are not updated by end-users, if one is looking
  3577.             for obsolete end-user made files, one will typically not want
  3578.             programs to be included in a file cleanup search.
  3579.  
  3580.      * Prompted if output is to go to a file, console or printer.
  3581.  
  3582.        KATSCAN                                                    P. 2
  3583.  
  3584.  
  3585.        -> If "File output" is chosen, user is:
  3586.  
  3587.           - Informed that an output DOS BATCH file, \KATCOPY.BAT, is made.
  3588.             When the program ends, if the user types: KATCOPY & presses
  3589.             ENTER, the files selected by the search will be copied to a
  3590.             specified target drive.
  3591.  
  3592.           - Prompted for the target drive letter; the number of KB that can
  3593.             fit on the target drive; & if only modified files are being
  3594.             searched, if the DOS BACKUP file attribute setting should be
  3595.             unmarked.
  3596.  
  3597.             + If the number chosen is 0, the target drive is assumed to
  3598.               have an unlimited KB size.
  3599.  
  3600.             + If the number chosen is greater than zero, when KATCOPY is
  3601.               ran, if it needs another diskette inserted, it will:
  3602.  
  3603.               o If desired, DBS-KAT will catalog the diskette (KAT -U1N
  3604.                 command).
  3605.  
  3606.               o Prompt user to insert another formatted diskette.
  3607.  
  3608.               o Pause until the user presses any key.  User should insert
  3609.                 new diskette before pressing any key.
  3610.  
  3611.               o Perform a DIR /W against the newly inserted diskette.
  3612.  
  3613.               o Prompt the user "If not okay to delete all the shown files,
  3614.                 either (1) answer "N" & continue with copying or (2) press
  3615.                 CTRL-BREAK & abort now."
  3616.  
  3617.                 This provides the user with a last chance to change his/her
  3618.                 mind before continuing.  If the user answers "N", the user
  3619.                 should have chosen an output number small enough that the
  3620.                 chosen files will have room to be added to the already
  3621.                 existing files on the target diskette (assuming there are
  3622.                 some).
  3623.  
  3624.               o Delete all the files in the current directory of the target
  3625.                 drive  (DEL *.*).  When given the prompt "Are you sure
  3626.                 (Y/N)?", the user can choose "Y" or "N" or CTRL-BREAK.
  3627.  
  3628.           - Prompted if one desires interactive authorization of each
  3629.             search-selected file.  If answer is "Yes":
  3630.  
  3631.             + As the search selects each file, it will display the drive,
  3632.               directory location, filename, date, time & filesize.
  3633.  
  3634.             + User is prompted for each displayed filename, "OK to setup for
  3635.               COPY?".  Chosen files won't be copied until the KATSCAN
  3636.               program ends, & the user types: KATCOPY & presses ENTER.
  3637.  
  3638.           - Prompted if one wants a delete-process batch file made of
  3639.             selected files.  If the answer is "Yes":
  3640.  
  3641.        KATSCAN                                                    P. 3
  3642.  
  3643.  
  3644.             + The created batch file name is \KATERASE.BAT.  After the
  3645.               KATSCAN program ends, the user can execute this delete-process
  3646.               by typing: KATERASE & pressing ENTER.
  3647.  
  3648.             + User is prompted if one desires interactive authorization
  3649.               of each search-selected file.  If answer is "Yes":
  3650.  
  3651.               o As the search selects each file, it will display the drive,
  3652.                 directory location, filename, date, time & filesize.
  3653.  
  3654.               o User is prompted for each displayed filename, "OK to setup
  3655.                 for DEL?".  Chosen files won't be deleted until the KATSCAN
  3656.                 program ends, & the user types: KATERASE & presses ENTER.
  3657.  
  3658.               o Answering "Yes" to both interactive authorization prompts
  3659.                 provides user with the opportunity of having a different
  3660.                 selection of files to copy than to delete.
  3661.  
  3662.             + At the end of the KATSCAN, the user is reminded that there is
  3663.               a KATCOPY batch command file to perform.
  3664.  
  3665.             + When the KATERASE process is actually executed, it will
  3666.               automatically delete itself when done.
  3667.  
  3668.           - Inform the user that the program will not select certain
  3669.             filenames.  These are:
  3670.  
  3671.             + Filenames which contain the phrase "KATDB.", except KATDB.LOG.
  3672.               These are the DBS-KAT database files which are usually large &
  3673.               are best backed up from within the DBS-KAT program itself, so
  3674.               that the DBS-KAT program, KAT, can keep track of database
  3675.               backups.
  3676.  
  3677.             + The KATSCAN created files, \KATCOPY.BAT, \KATERASE.BAT, and
  3678.               \KATBACK.BAT.
  3679.  
  3680.             + Selected files whose size are greater than the user indicated
  3681.               maximum KB size are not included in the \KATCOPY.BAT file.
  3682.  
  3683.               o They are instead included in a DOS batch command file which
  3684.                 can back these files up to the same target drive using the
  3685.                 DOS BACKUP command.
  3686.  
  3687.               o The created command file is called \KATBACK.BAT.
  3688.  
  3689.               o At the end of the KATSCAN, the user is reminded that there
  3690.                 is a KATBACK batch command file to perform.
  3691.  
  3692.           - Informs the user at the end of the KATSCAN, of how many
  3693.             formatted diskettes are needed to perform the KATCOPY process.
  3694.  
  3695.        -> If Console or Printer output is chosen:
  3696.  
  3697.           - Column headings will be printed once.  Headings are: Filename,
  3698.             Size, Date, Time, Since Last B/U.
  3699.  
  3700.        KATSCAN                                                    P. 4
  3701.  
  3702.  
  3703.             + The "Since Last B/U" column will be blank unless the
  3704.               corresponding file has been modified since the last DOS
  3705.               BACKUP.
  3706.  
  3707.             + Note, other backup programs may modify a DOS file attribute,
  3708.               such as FASTBACK.
  3709.  
  3710.             + Modified files will show the abbreviation "MOD" on the output
  3711.               display.
  3712.  
  3713.             + System files will show the abbreviation "SYS" on the output
  3714.               display.
  3715.  
  3716.           - Provide a fileset size subtotal per directory & per drive.
  3717.  
  3718.           - If console output is chosen, the user is displayed one screenful
  3719.             of output & the phrase "--More--".  The program pauses until
  3720.             any key is pressed, at which time another screenful will be
  3721.             displayed.
  3722.  
  3723.           - If printer output is chosen, a formfeed is done at the end of
  3724.             the display.
  3725.  
  3726.  
  3727.               EVERYTHING DESCRIBED HERE IS ON THE ENCLOSED DISKETTE.
  3728.                             THIS IS NOT DEMO SOFTWARE!
  3729.  
  3730.  
  3731.  
  3732.                                         =SC
  3733.  
  3734.  
  3735.  
  3736.  
  3737.  
  3738.                              THE DB-SHAREWARE PROGRAM
  3739.  
  3740.  
  3741.  
  3742.                                         by
  3743.                                     R.H. Martin
  3744.  
  3745.  
  3746.  
  3747.                               Applied Foresight Inc.
  3748.                                   P.O. Box 20607
  3749.                              Bloomington, Minn.  55420
  3750.  
  3751.  
  3752.                                   April 24, 1990
  3753.  
  3754.  
  3755.  
  3756.                            Copyright 1986 by R.H. Martin
  3757.                                 All Rights Reserved
  3758.  
  3759.  
  3760.  
  3761.  
  3762.  
  3763.  
  3764.  
  3765.  
  3766.  
  3767.  
  3768.  
  3769.  
  3770.  
  3771.                                                              Trademark Pending
  3772.  
  3773.  
  3774.  
  3775.  
  3776.  
  3777.  
  3778.  
  3779.  
  3780.        DB-SHAREWARE PROGRAM      Copyright 1986-90 R.H. Martin      P. 2
  3781.  
  3782.  
  3783.                        ABOUT DB-SHAREWARE SOFTWARE PRODUCTS
  3784.                        ------------------------------------
  3785.  
  3786.                                      OVERVIEW
  3787.  
  3788.      DB-SHAREWARE is a new and un-trademarked designation referring to a
  3789.      modified SHAREWARE product where the programmer has developed software
  3790.      revolving around a network model database, using a compiled language-
  3791.      driven, run-time royalty-free and license-free database manager.
  3792.  
  3793.      The DB-SHAREWARE designation was originally entitled "DB-SHARE", however
  3794.      Applied Foresight Inc. became aware of an advertisement in the April 1986
  3795.      issue of DATA BASED ADVISOR that JCL Software has declared a trademark on
  3796.      a product, called "dBSHARE II".  This trademark is close enough to cause
  3797.      confusion and to avoid this, the "DB-SHARE" concept is being renamed "DB-
  3798.      SHAREWARE".   Although this makes the term similar to "SHAREWARE", since
  3799.      the "SHAREWARE" term is not trademarked and is meant to apply to
  3800.      anybody's offered software who follow the "SHAREWARE" concept, and the
  3801.      "DB-SHAREWARE" is a slight modification of this concept, the closeness is
  3802.      justified and there are no legal considerations to be concerned with.
  3803.  
  3804.      SHAREWARE is an untrademarked term used by Quicksoft (TM), the developer
  3805.      of PC-WRITE (TM).  Write Quicksoft, 219 First N. #224, Seattle, WA
  3806.      98109.  Bob Wallace, the developer of PC-WRITE, describes SHAREWARE in
  3807.      his manual as follows:
  3808.  
  3809.         "Shareware is our term for software that can be freely copied and
  3810.         shared.  The term (from an INFOWORLD column) describes both public
  3811.         domain (non-copyrighted) software, and copyrighted software, like PC-
  3812.         WRITE, which the author supports and encourages people to copy and
  3813.         share.
  3814.  
  3815.         "Shareware is like public television: the programming is freely dis-
  3816.         tributed, but support from users is encouraged.  The concept is based
  3817.         on these principles:
  3818.         1.  People need to try programs to see if they are useful.
  3819.         2.  Software authors can be supported directly by users.
  3820.         3.  Copying and networking of programs can be encouraged.
  3821.  
  3822.         "To quote Andrew Fluegelman: 'This is an experiment in economics more
  3823.         than altruism.  Free distribution of software and voluntary payment
  3824.         for its use would eliminate the need for money to be spent on
  3825.         marketing, advertising, and copy protection schemes.  Users could
  3826.         obtain quality software at reduced cost, while still supporting
  3827.         program authors.'
  3828.  
  3829.         "Quicksoft takes the Shareware concept further by giving additional
  3830.         materials and services when someone registers, and giving a commission
  3831.         to people who distribute copies."
  3832.  
  3833.      Anyone is allowed to sell or give away wholly unmodified copies of the
  3834.      official Shareware-release diskette.  The "official" release is the one
  3835.        DB-SHAREWARE PROGRAM      Copyright 1986-90 R.H. Martin      P. 3
  3836.  
  3837.  
  3838.      released by the software author.  Shareware does not allow distribution
  3839.      of any modified software copies, nor source files, nor printed copies of
  3840.      the manual, without permission of the Shareware author.
  3841.  
  3842.  
  3843.                                      FEATURES
  3844.  
  3845.      DB-SHAREWARE differs slightly from the Shareware program.  The main fea-
  3846.      tures of a DB-SHAREWARE software product are:
  3847.  
  3848.      1.  The software package revolves around a network model database, using
  3849.          a compiled programming language-driven, run-time royalty-free and
  3850.          license-free database manager.  So far, only DB-VISTA by RAIMA Corpo-
  3851.          ration seems to fit this requirement.  DB-VISTA is sold by RAIMA Cor-
  3852.          poration, 12201 SE Tenth St., Bellevue, WA 98005.  RAIMA Corporation
  3853.          is NOT connected with Applied Foresight nor the DB-SHAREWARE program.
  3854.  
  3855.          One could justifiably include in the DB-SHAREWARE category, otherwise
  3856.          qualified software but instead of being a compiled programming lan-
  3857.          guage driven, run-time royalty-free database manager, alternative
  3858.          software using such royalty free database products as the CLIPPER and
  3859.          WORDTECH dBASE III royalty-free compilers.  Likewise, substitute
  3860.          royalty-free sophisticated file-access systems, like BTRIEVE by
  3861.          SoftCraft, could be a component of a DB-SHAREWARE product, because
  3862.          intelligent use of key file access systems can make a program perform
  3863.          as if it was a program dependent on a network model database manager.
  3864.  
  3865.      2.  The base package is distributed similar to SHAREWARE.  Parts of the
  3866.          code may be copyrighted software by the involved author and other
  3867.          parts may be public-domain coded subroutines.  Due recognition is
  3868.          given to any public domain code utilized.  Anyone is allowed to sell
  3869.          or freely give away wholly unmodified copies of the DB-SHAREWARE base
  3870.          software diskette.  DB-SHAREWARE  does not allow distribution of any
  3871.          modified software copies, nor source files, nor printed copies of the
  3872.          manual, without permission of the DB-SHAREWARE author.  Policy about
  3873.          manual copying may vary amongst authors.
  3874.  
  3875.      3.  The base package must be completely useable and practical without the
  3876.          need for the optional (by purchase) add-on package.  Those users who
  3877.          like the base package and want the luxury optional program features
  3878.          provided by the add-on package, can register with the software author
  3879.          and receive the add-on package and several other benefits.
  3880.  
  3881.          However, the base package must be good enough on its own merit to
  3882.          generate a widespread public enthusiasm for it and be able to sustain
  3883.          widespread copying and cheap or free distribution of it.  The base
  3884.          package is NOT to be viewed as a demo software product.  The add-on
  3885.          package provides only luxury features, not needed to functionally use
  3886.          the base package in a practical manner.
  3887.  
  3888.      4.  A DB-SHAREWARE add-on software diskette will only be distributed by
  3889.          the author or legally contracted distributors.  A harmless, but gen-
  3890.        DB-SHAREWARE PROGRAM      Copyright 1986-90 R.H. Martin      P. 4
  3891.  
  3892.  
  3893.          erally persuasive security measure may be used to prevent
  3894.          unauthorized distribution of a DB-SHAREWARE add-on software diskette.
  3895.  
  3896.          The diskette would then contain in an encrypted manner, the
  3897.          customer's name and serial number, which will become encryptically
  3898.          embedded in any and all user databases which have the add-on program
  3899.          ran against it.  Thereafter, everytime any base DB-SHAREWARE program
  3900.          or add-on DB-SHAREWARE program is ran against that user's database,
  3901.          the decrypted user's name will appear on the screen and printouts.
  3902.          DBS-KAT uses the following manner.  ("XYZ" stands for the DB-
  3903.          SHAREWARE database name.)
  3904.  
  3905.        *********************************************************************
  3906.              XYZ Database of: John Q. Owner                    S/N 99999999.
  3907.        *********************************************************************
  3908.  
  3909.          Although, some unscrupulous persons may still copy an add-on DB-
  3910.          SHAREWARE program, they will have to put up with their computer
  3911.          screen and printouts advertising the fact that they are unscrupulous.
  3912.          Any known instances of copyright violations of a DB-SHAREWARE add-on
  3913.          program diskette should be reported to the software author.
  3914.  
  3915.          Some dishonest persons may order this year's upgrade add-on module
  3916.          and their friend might order next year's add-on module, and then both
  3917.          might share programs, except that one runs the other's programs in
  3918.          reverse order so that finally one's own name gets embedded in their
  3919.          individual's DB-SHAREWARE database.  To disallow this, an add-on DB-
  3920.          SHAREWARE program will only re-update its embedded owner's name, if
  3921.          the add-on version number is newer than the last re-update embedding.
  3922.  
  3923.      5.  Each DB-SHAREWARE software author is independent of other DB-
  3924.          SHAREWARE software authors, unless specifically stated.  The quality
  3925.          and reputation of each DB-SHAREWARE software product reflects only
  3926.          upon the responsible individual author.
  3927.  
  3928.      6.  DB-SHAREWARE add-on software will be minimally priced, rarely if ever
  3929.          going over a two digit price figure for any personal computer
  3930.          application.  If the DB-SHAREWARE targed audience is small, a DB-
  3931.          SHAREWARE developer can sustain one's revenue needs through offering
  3932.          multiple, inxpensive add-on software modules for a base DB-SHAREWARE
  3933.          software product.
  3934.  
  3935.      7.  DB-SHAREWARE authors should have a conscientious committment to
  3936.          upgrade both the base DB-SHAREWARE and DB-SHAREWARE add-on software
  3937.          whenever feedback from users indicate that deficiencies exist.  Any
  3938.          deficiency affecting functional use of the base package in a prac-
  3939.          tical manner, when resolved, should appear in the base DB-SHAREWARE
  3940.          product.
  3941.  
  3942.  
  3943.                                      PHILOSPHY
  3944.  
  3945.      Besides sharing the concepts behind SHAREWARE, DB-SHAREWARE has addi-
  3946.      tional concepts.  Software products revolving around a compiled-language
  3947.        DB-SHAREWARE PROGRAM      Copyright 1986-90 R.H. Martin      P. 5
  3948.  
  3949.  
  3950.      drive database manager are typically applications that are many faceted.
  3951.      There are the basic facets which critically maintain and use the
  3952.      application and there are numerous "peaches and cream" facets which make
  3953.      the use of the application even more worthwhile.
  3954.  
  3955.      A DB-SHAREWARE software developer knows that one's development effort
  3956.      will be financially rewarded if one has developed a base package that
  3957.      people love to use and copy, because anyone who uses the base package
  3958.      long enough will eventually want and will likely get the add-on software.
  3959.      However, the secret to a software developer's success is to make the base
  3960.      package highly desirably useful in its base state, because otherwise the
  3961.      initiative to enthuasiastically use it and share that enthusiasm through
  3962.      copying and sharing it with others will not be there.  Without that
  3963.      enthusiasm over the base DB-SHAREWARE product, there will not be enough
  3964.      of a distribution spread and hence any derived registrations will be less
  3965.      than desired.
  3966.  
  3967.      The above formula is a "you win-I win" formula for both the developer and
  3968.      the customer.  The customer gets a very useful base product free (or
  3969.      nearly free, if an intermediate distributor charges a handling fee) and
  3970.      is able to get add-on features direct from the developer, or an
  3971.      authorized distributor, for minimal costs.  The developer wins because a
  3972.      widespread enthusiasm of one's base product will naturally be followed by
  3973.      numerous registrations.  The developer is protected from widespread
  3974.      copying of the add-on diskettes, because of the security protection
  3975.      device.  The honest customer is not hassled by the security protection,
  3976.      because infinite number of backup copies can be made, and the software
  3977.      employs no floppy-dependent mechanisms.
  3978.  
  3979.      Either party (user and author) is only going to win in this situation if
  3980.      the other party is allowed to win.  Thus, the challenge goes out to
  3981.      future DB-SHAREWARE developers: "Don't put out anything but an excellent
  3982.      base product!"   If the public's feedback to the base DB-SHAREWARE
  3983.      product is less than enthusiastic, improvements deserve to be put in the
  3984.      base DB-SHAREWARE product, not necessarily the DB-SHAREWARE add-on
  3985.      modules.
  3986.  
  3987.  
  3988.                         LIMITATION OF DB-SHAREWARE COVERAGE
  3989.  
  3990.      Not all data base dependent software lends itself to the DB-SHAREWARE
  3991.      concept.  Complicated software requiring accompanying audio visual
  3992.      training material, and implementation or maintenance assistance by local
  3993.      consultants are two obvious types of software beyond the applicable range
  3994.      of the DB-SHAREWARE concept.  Software easily able to be a success in a
  3995.      conventional commercial manner would be foolish to distribute in a DB-
  3996.      SHAREWARE manner.
  3997.  
  3998.      DB-SHAREWARE makes sense for those database dependent applications that
  3999.      are simple to use and which would be overpriced and undersold if sold via
  4000.      conventional methods.  It also makes sense for cash-starved start-up com-
  4001.      panies.
  4002.        DB-SHAREWARE PROGRAM      Copyright 1986-90 R.H. Martin      P. 6
  4003.  
  4004.  
  4005.                                                                            =UP
  4006.                 UPDATING DBS-KAT(r) SOFTWARE TO VERSION 2.25 WHEN YOUR
  4007.                CURRENT DBS-KAT DATABASE IS CURRENTLY AT 2.0 OR GREATER
  4008.  
  4009.                               by Applied Foresight, Inc.
  4010.                                     P.O. Box 20607
  4011.                               Bloomington, Minn.  55420
  4012.                          (C) Copyright 1986-1990 R.H. Martin.
  4013.                                  All Rights Reserved.
  4014.                                     April 24, 1990
  4015.  
  4016.  
  4017.         Version 2.23 users, read page 3 of this document section (you can
  4018.         skip the material in between, as it's old documentation).  Find the
  4019.         phrase "2.23 TO 2.25" to get there quickly.
  4020.  
  4021.         Raima Corporation, the developer of DB_VISTA, which is the database
  4022.         manager used by DBS-KAT, found some rare occurring problems with 2.10
  4023.         of DB-VISTA, which was used for PC-KAT and pre-2.0 versions of DBS-
  4024.         KAT.  DB-VISTA release 2.11 was released to fix these rare occurring
  4025.         problems (so rare, that I never noticed anything except once amiss
  4026.         after processing 20,000 filenames and nearly 1,000 diskettes).  DBS-
  4027.         KAT releases as of 2.0 through 2.10 use DB-VISTA 2.11.
  4028.  
  4029.         Even rarer database problems, but still some, have been reported by
  4030.         Raima Corporation, for version 2.11 DB_VISTA.  Applied Foresight has
  4031.         only been informed of two of its registered users having problems with
  4032.         2.11 DB_VISTA.  In one of those cases, the suspected culprit was a
  4033.         non-MSDOS operating system shell.   I, myself, have never encountered
  4034.         database problems with DB_VISTA version 2.11.  But because of the
  4035.         advice received by Raima Corporation, DBS-KAT has been updated to
  4036.         DB_VISTA 2.21 (along with updating to Lattice C, version 3.21),
  4037.         effective with DBS-KAT version 2.21.
  4038.  
  4039.         This DB_VISTA update only affects DBS-KAT software and not the DBS-KAT
  4040.         database (KATDB.* files).  A DBS-KAT database (KATDB.* files) being
  4041.         used with DBS-KAT software, versions 2.0 through 2.10, will remain
  4042.         unchanged in an update to version 2.25.  One will only need to change
  4043.         the DBS-KAT software.  (Note to version 2.23 users: see the 
  4044.         postscript subsection at the end of this section.)                                      
  4045.  
  4046.         The instructions below show how to do this.
  4047.  
  4048.         If you currently are using DBS-KAT or PC-KAT software, prior to
  4049.         version 2.0, do NOT follow the below instructions.  Instead, follow
  4050.         the instructions elsewhere (press "Home" then find "TU").
  4051.  
  4052.            A.  Change to the directory where you installed the DBS-
  4053.                KAT (KATDB.*) database.   For example, if you
  4054.                installed DBS-KAT in the \DBSKAT directory, type:
  4055.  
  4056.                CD  \   and press ENTER.
  4057.  
  4058.            B.  Backup your converted DBS-KAT database (KATDB.* files) now.
  4059.                You'll restore this after you've installed DBS-KAT release
  4060.                2.25.
  4061.  
  4062.                Use the backup method that you've been using.  ONLY BACK UP
  4063.                THE "KATDB.*" FILES!
  4064.  
  4065.  
  4066.       DBS-KAT UPDATE DOCUMENTATION    Copyright 1990 R.H. Martin    P. 2
  4067.  
  4068.            C.  To install the new software for release 2.25 of DBS-KAT, you
  4069.                need to perform the following steps:
  4070.  
  4071.                    #   ACTION  EVENT OR COMMAND    COMMENT
  4072.                    --  ------  -----------------   -----------------------
  4073.                    1   Type    C:                  Move to your hard disk.
  4074.  
  4075.  
  4076.                    2   Type    CD \DBSKAT          Move to the \DBSKAT
  4077.                                                    directory if DBS-KAT
  4078.                                                    was installed there,
  4079.                                                    else move to the
  4080.                                                    directory where DBS-
  4081.                                                    KAT resides.
  4082.  
  4083.                    3   Type    VERIFY ON           Ensure better file
  4084.                                                    copies.
  4085.  
  4086.                    4   DO      Delete all old DBS-KAT or PC-KAT files off
  4087.                                your hard disk.  (Do not undo nor delete
  4088.                                whatever is in CONFIG.SYS or your
  4089.                                AUTOEXEC.BAT files; nor should you delete
  4090.                                whatever DOS programs were needed to work
  4091.                                with your old DBS-KAT.)
  4092.  
  4093.                                For example, in the directory where you
  4094.                                previously installed DBS-KAT, type:
  4095.  
  4096.                                DEL KAT*.*     and press ENTER.
  4097.                                DEL KPRINT.*   and press ENTER.
  4098.  
  4099.                    5   Insert DBS-KAT 2.25 diskette in drive A:.
  4100.  
  4101.                    6   Follow DBS-KAT 2.25 manual instructions to install
  4102.                        DBS-KAT.  Print the manual by following the in-
  4103.                        structions in the READ.ME file.
  4104.  
  4105.                           Type:    TYPE  A:READ.ME   and press ENTER.
  4106.  
  4107.                    7.  Restore your earlier backed up converted DBS-KAT
  4108.                        database.  If you used the DOS BACKUP command with
  4109.                        your backup, insert diskette 1 of your backup set
  4110.                        in drive A: and type:
  4111.  
  4112.                        RESTORE  A:  C:KATDB.*   and press ENTER.
  4113.  
  4114.                    8.  You're done!
  4115.         
  4116.      
  4117.  
  4118.       DBS-KAT UPDATE DOCUMENTATION    Copyright 1990 R.H. Martin    P. 3
  4119.  
  4120.                           POSTSCRIPT FOR THOSE UPDATING FROM 
  4121.                              DBS-KAT VERSION 2.23 TO 2.25
  4122.  
  4123.         Version 2.25 only changes the documentation files and adds the 
  4124.         ML.EXE & HELP.ML files to DBS-KAT, as well as adds back VOLSER.COM --
  4125.         for those who don't have LABEL.COM.  Only the following file actions 
  4126.         are needed:
  4127.  
  4128.         KATBOOK.OUT    OLD - Delete this file (it's obsolete now).
  4129.         KATBOOK        NEW - Copy to your existing DBS-KAT subdirectory.     
  4130.         ML.EXE         NEW - Copy to your existing DBS-KAT subdirectory.     
  4131.         HELP.ML        NEW - Copy to your existing DBS-KAT subdirectory.     
  4132.         KATORDER.FRM   UPDATED - Copy to your existing DBS-KAT subdirectory.
  4133.         KATBUG.FRM     UPDATED - Copy to your existing DBS-KAT subdirectory.
  4134.         READ.ME        UPDATED - Optional, not needed on your hard disk.
  4135.         VOLSER.COM     BACK - Optional, use if you don't have LABEL.COM.
  4136.  
  4137.  
  4138.                                                                           =SD
  4139. April 22, 1990                                          FOR IMMEDIATE RELEASE
  4140.  
  4141.            ShareDebate International: A ShareWare Diskette Magazine
  4142.  
  4143.                   "An International Debate Forum for PC Users
  4144.                    Concerned About the Present & the Future"
  4145.  
  4146.    Applied Foresight, Inc. released its first issue of ShareDebate 
  4147. International, a ShareWare diskette magazine, which is a quarterly debate 
  4148. forum for PC users by PC users who are concerned about the present and the 
  4149. future.  It is published by Applied Foresight Inc., PO Box 20607, Bloomington 
  4150. MN 55420. 
  4151.  
  4152.    Ben Bova, former editor of OMNI & ANALOG magazines & author of more than 60 
  4153. books (lately CyberBooks), released a public statement on April 9, 1990, about 
  4154. ShareDebate International.  Mr. Bova writes "Electronic publishing has 
  4155. arrived!  ShareDebate International is a bold, exciting venture that deserves 
  4156. the attention & support of everyone who seeks to create a better tomorrow."  
  4157.  
  4158.    Issue 1 can be downloaded from many bulletin boards including: 
  4159.  
  4160. * Compuserve as DBATE1.EXE in the Science Fact library of the SCI-FI forum; 
  4161. * GENIE as DBATE001.ZIP (file 17976) in Library 3 of the IBM PC S/W Library;
  4162. * Byte's BIX as DBATE001.EXE in the filearea, IBM.UTILS; and
  4163. * ShareWare Distributor's Network (SDN!Works) as DBATE001.SDN (this BBS is
  4164.   mostly for member BBS sysops).
  4165.  
  4166.   Issue 1 is also on ShareWare CD-ROM collections.  It is PC-SIG disk number 
  4167. 2121 and is on its Spring 1990 CD-ROM disk (PC-SIG, 1030-D East Duane Ave., 
  4168. Sunnyvale, CA 94086).  Reportedly, orders for ShareWare Gold CD-ROM by Quanta 
  4169. Press also includes ShareDebate International (Quanta Press, 2239 Carter Ave., 
  4170. PO Box 8044, St. Paul MN 55108).  
  4171.  
  4172.   Many diskette-only based ShareWare distributors carry ShareDebate 
  4173. International -- too numerous to mention here.
  4174.  
  4175.   All ShareWare distributors who notify Applied Foresight Inc. that they carry 
  4176. ShareDebate International will receive past and future issues -- Subscribers 
  4177. will receive their issues first however. 
  4178.  
  4179.    R.H. Martin, president of Applied Foresight, Inc. (POB 20607, Bloomington
  4180. MN 55420), and an accomplished author, is the editor.  He has a Master's
  4181. degree in Sociology (dual undergraduate minor in Science and Political
  4182. Science), a diploma in data processing, four years in the research world, and
  4183. 12 years in the world of computers.
  4184.  
  4185.    The magazine uses a feature-rich diskette-publishing ShareWare software 
  4186. package, Iris, which is by UserWare (no connection to Applied Foresight Inc., 
  4187. however AFI is a registered user of Iris).  For more about Iris, write 
  4188. UserWare, 4 Falcon Lane East, Fairport NY 14450.
  4189.  
  4190.    The Charter issue advances six debate forums and solicits non-fiction and 
  4191. fiction writers to deal with the issues.  Writers and editors are provided 
  4192. with a payment schedule.  Subscription is $25 per year.  
  4193.  
  4194.  
  4195.    Issue number 1 is available to DBS-KAT registered users free (if you're 
  4196. already registered, send $1 to cover postage) and is available for $3 for 
  4197. unregistered DBS-KAT users.  The $3 charge to unregistered users covers the 
  4198. shipping and handling costs for USA and Canada users and orders from other 
  4199. countries should include an extra $1.  (This is a cash discount price--
  4200. Visa/MasterCard--see order form; foreign cash orders must be drawable against 
  4201. a US bank and paid in US dollars.)  Use the DBS-KAT order form to place your 
  4202. order (type KAT -O  or else type: COPY  KATORDER.FRM  PRN  and press ENTER). 
  4203.  
  4204.    The debate forums established in the first issue deal with a National 
  4205. Interest Project-Level Stock Market; Occupational Representation vs 
  4206. Geographical Representation for Voter Districting; Computer Modeling Future 
  4207. Cities to Fight the Greenhouse Effect and Strengthen the Economy; Japanese vs 
  4208. U.S. Patent Law; Economic Impact of Corporate Income Tax; and the Existing 
  4209. Cost of Government Intervention in Health Areas. 
  4210.  
  4211.    A distributor identification capability is built into the magazine, along 
  4212. with a commission schedule, so that readers can become distributors and earn 
  4213. money copying the magazine, whether they subscribe or not. 
  4214.  
  4215.    Hardware  Requirements: IBM PC, PC-compatible or MS-DOS computer 384k RAM, 
  4216. 1 floppy drive. 
  4217.  
  4218.    Other Requirements: DOS 2.1 or higher. 
  4219.  
  4220.